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For those who seek knowledge, reading is the beginning. 
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Acknowledgements 


“Encouragement is the first facet of interest.” 


Welcome to PW Lib in a Nutshell. In this book you will learn how to develop Phoenix Wright games 
using the PWLib library for Anime Image Game Engine. You won’t need introduction to AIGE’s AHLSL scripting 
language in order to follow this book, as all needed lessons on that scripting language will be given as necessary. Also the 
methodology used in this book is incremental, so each tutorial will increment new features to the program developed on 
the previous tutorial. This book was designed according to the PW Lib H ayase. 

Asa matter of formatting, this book use colored boxes that has each one its own objective Red boxes are 
extra information about something specified. O range boxes are used as specific comments of the book’s author with the 
reader. Blue boxes are tips. 

But before you begin, you will need a good text editor for programming (N otepad+ is the best bet). So, 
once you have one installed, get ready to enter the world of PW Lib. W e hope you will have a great time developing with 
PW Lib. Get the tool in hand, and step forward! 
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asic Tutorials 


“A sturdy foundation is the perfect base for great outcome.” 


First, let’s explore the basics of PW Lib game development, so we can gather a good base to work on more 
complex features. Learning the basics will not only allow you to develop simple games, but also serve as the stepping 
stone to start the Court Room T utorials. So take your time to understand the flow of the program and how it works. 
Later tutorials will rely on knowledge obtained here. With it, most of the features will be already at your hands, and so 
your path to start working with full Ace Attorney games will be mostly open. Ready to ride? 
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Tutorial 00: 


Setting Up PW Lib 


Ok, the first step to begin a Phoenix W right game is to setup AIGE to use PW Lib, so AIG E has access to 
PWLib’s features. But to do so, a little lesson on AHLSL is required. Let’s begin this tutorial with it. 


The two required AHLSL features are functions and script inclusion. Functions are mainly a block of 
commands. This is one of the most important features that will be used constantly on PW Lib development. Script 
Inclusion allows you to include other files containing scripts for use. It mainly is used for better management and reuse 
of code aside from allow using features created by other programmers. As we need PWLib’s features, we will include the 
PWLib’s script. 

Firstly, let’s work on functions. They are easy to create. You first give it a name and declare it this way: 
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[myfunc] 


And that is your function named myfunc. The name is surrounded by [ and ]. But is has no body yet. 
The body is the collection of commands that will be called when you run the function. But what limits the body of a 
function? That’s simple: other function declaration or the end of the file. This means that blank lines won’t cut the 
function’s body. You can use blank lines to separate the code for better visibility, but this lesson is for other tutorial. 
H ere is a simple 3 function example: 


[callphoenix] 
message(“Calling Phoenix Wright! Attention!”); 
message(“Maya is calling! A lawyer is required.”); 


[callmayal] 
message(“Calling Maya Fey!”); 


message(“Medium required!”); 


[calledgeworth] 
message(“Calling Miles Edgeworth!”); 


message(“A prosecutor is needed!”); 


We have more commands on AHLSL than message, but since this isn’t an AHLSL-guided book, we 
won’t explain more unless needed. So don’t try to test these scripts yet. They are purely for example as one special setup 
is needed (that will be explained in the end of this section). 

OK, you have three functions, but how to USE then? T here are two main commands on AH LSL for that 
task: runscript and jumptoscript. But they don’t do the same thing, so explanation is required. 

Runscript basically goes to the function called if it exists, but as the last command in it is executed, it 
returns to the calling point. Sounds complicated? It isn’t really. Let’s look to a piece of code that will make it easier to 
understand: 
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[runme] 
message(“I’m running!”); 


[runner] 

message(“I’ll run it!”); 
runscript(“runme”); 
message(“I ran it”); 


In this example, runner will show the message “I'll run it”, then will run the script runme. Going to 
runme, it will show the message “I’m running”, then return to the runner function at the runscript point, and continue 
executing runner from that point (thus showing the message “I ran it”). 

Jumptoscript acts similarly to runscript, but with a crucial difference: it doesn’t return to the calling 
point. It “jumps” from one function to another. 

But now you may ask: what if | use one runscript in a function called by other runscript? Is it possible? 
Yes, it is. AH LSL knows how to return in the correct order, without limits on depth. But take care with runscripts: you 
can make a loop with them quite easily. H ere is one simple example of loop: 


[fa] 


runscript(“fb”); 


[fb] 


runscript(“fa”); 


Also one last note: jumping from functions will keep the runscript stack (list of return points). 


Pll explain about the message command on AHLSL. If you feel it’s complicated you can skip it now as it 
won’t be an issue on basic PWLib development. Some commands on AHLSL are stopper commands (they stop the 
execute flow of AH LSL). M essage is one of them. T o advance you need to use the advance command (setup properly on 


a button or a key event), which we didn’t do now, so running the tests would leave you locked up. Also, message uses the 


M essage Box that needs to be setup and shown. PWLib does Message Box setup, so you won't need to care about it 
while using PW Lib (only needing to show the M essage Box, which will be explained in Tutorial 1). 


Now let’s go to the script inclusion. Script inclusion is the one of the spirits of AHLSL’s simple 
expansion. With it you can easily add stuff to your scripts without hassle. But a note is required before explaining how to 
do it. T he script inclusion is a preprocessor command, so it must PRECEED ALL functions on you file If define inside 
a function, AIGE will automatically ignore it. So place it on the top of your file, before any function declarations. With 
that said, let’s explain it: 


#include(script) 


And that’s it. Script is the path to your script relative to the AIG E.exe file (so all scripts must be placed on 
the folder that AIG E.exe is on). You can put on subfolders too without issues. (PW Lib itself uses subfolders). You can 
include files that include others without problems, too. 


OK, now all requirements for starting with PW Lib development have been given. It’s time to start. 

First of all, let’s create the file that will be the tutorial game’s script file. On the same folder as AIGE.exe, 
create a file with the name “tutogame.hlsl”. It could be .txt, or anything of your liking. O pen it with your preferred text 
editor program (N otepad-++ for example). 

Now let’s make AIGE use PWLib library. On the first line, put: 
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#include(pwlib/pwlib.hisl) 


That’s the inclusion of PWLib to your project. N ow create the function game. It MUST be game, and 
the reason will be explained just a bit ahead. So your file will be like this now: 


#include(pwlib/pwlib.hisl) 


[game] 
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The game function is the entrypointy (start point) of your Phoenix Wright game But only including 
PWLib’s files won’t setup everything. A command is required to initialize PWLib on AIGE. For that, the command is: 


runscript("pw_initpwlib"); 


That will run all initialization and configuration functions for PW Lib. So adding it to the game function 
tells AIGE to init PW Lib. Is that all? Almost. There is a behavior in AIGE that must be explained. A function when 
there is nowhere to return to will rerun itself indefinitely. So we will place a special command to hold the script’s 
execution after the PW Lib initialization command so you can run and test the script. It is: 


waitresponse(); 


With this, your tutorial file comes to this result: 


#include(pwlib/pwlib.hlsl) 


[game] 
runscript("pw_initpwlib"); 
waitresponse(); 


But you can’t run the script yet. AIGE needs to know that you want to use tutogame.hlsl. (and why you 
need to use the game function). There is a file named startup.aigehis on the same folder as AIG E.exe. That file is the 
answer. O pen it. This file is the file that AIGE always include. It is the “entrypoint script” for ALL AIGE games. You 
will see lines beginning with “//”. Those are comments (lines that will be ignored, but used to add comments about the 
code). 

After the first set of comments, you must add a #include to include your file tutogame.hlsl. 


#include(tutogame.hlsl) 


Once it’s done, save both files. If you noticed, there is a function main there on startup file. This main 
function (as it is in the comments) is the first function that AIGE calls. And in the body of this function you see a 
jumptoscript to the function game. That’s why we use the function game on the tutogame file. You can edit this file to 
suit your needed, but let’s leave it simple for now as you’re beginning on AIGE and PWLib development. Let’s keep it 
simple, for now. 

N ow with your script completed, you can run AIGE.exe and see the results. Not much more than a white 
screen for now. But let’s add stuff in the next tutorial. Give life to your game, shall we? 
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Tutorial 01: 


M aking A M onologue 


Okay. I hope you’re ready to make you first scene. Taking up from the last tutorial code, we can start 
setting up the required features to create a talk on PW Lib. We will use some of the built-in characters and backgrounds 
on the tutorials for easy learning, but you can always use the Customization Tutorials to include your characters and 
backgrounds. 

First of all, let’s initialize the built-in backgrounds. You can remove the waitresponse() from last tutorial. 
Just below the runscript("pw_initpwlib"); you will use PWLib’s built-in background initialize: 


runscript("pw_initpwbgs"); 


Now we have backgrounds initialized. But what about characters? In PWLib we have characters 
separated, so you have to init the ones you need. In this case we will use Young Ema. For that you put: 


runscript("pw_createema"); 


That will setup Young Ema characters properly. In the end your game function code will be like this: 


[game] 
runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("pw_createema"); 


You have the character and the backgrounds ready. But let’s change the game’s title on the window title 
bar just to make it better. For that you use: 


changetitle(“yourtitle”); 


The “yourtitle” will be the window title. In this case we will use PWLib Tutorial Game. But now to the 
talking part. As a matter of organization, we will separate the scene from the initialization. To do that, we will create a 
new function, called run. 

With it in place, we will jump from game to run just after the changetitle command, like this: 


[game] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("pw_createema"); 
changetitle(“PWLib Tutorial Game”); 


jumptoscript(“run”); 


[run] 
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On the run we will start the scene and put some talking to Ema. But before you can make her talk, you 
need to setup the scene. Asa first command, you enable the character on screen with: 


runscript("showpwchar"); 


Then you must enable the M essage Box itself: 
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runscript("pw_showmessagebox"); 


And with this set, you need to set the background of the scene: 


runscript("pw_useowbgcourthall"); 


W ewill be using the D efense Lobby one O kay, now background set, we must set the name box (the box 
that shows the name of who’s speaking). That is simple: 


runscript("pw_setnameboxtoema"); 


The box will show Ema’s name. N ow we want her to move her lips when talking. So we enable the lip- 
sync support: 


runscript("setlipsynctochar"); 


But aren’t we missing something? Oh, yeah, the character itself! W hat will be the pose will she use? We 
set it by using: 


runscript("pw_enableemanormal"); 


Now Ema will show her normal pose With that set, we show the advance arrow menu (as it is an special 
command that executes effects and forces AIGE to wait its completion, it must come only after all initial scene data is 
defined.(As in this case We didn’t had any scene setup earlier!): 


runscript("pw_showadvarrowmenu"); 


Now, what we must do? Give Ema some lines, yeah! Using message commands you give her lines to 
speak! 


message{"Y es!"); 
message("M y name is Ema Skyel"); 


Two lines of text! Seems good... And when you do the last talk line, AIGE will resume from the top of 
the function, that’s expected. W ith this our file is like this in the end: 


#include(pwlib/pwlib.hlsl) 


[tutomain] 
runscript("pw_initpwlib"); 
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runscript("pw_initowbgs"); 
runscript("pw_createema"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[run] 

runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_usepwbgcourthall"); 
runscript("pw_setnameboxtoema"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_showadvarrowmenu"); 
message("Y es!"); 

message("M y name is Ema Skyel"); 


Congratulations, this is your first PWLib “game”. It’s not much, but it is the first one that has some 
functionality. W e will make it even better in the next tutorials. W e are just beginning with PW Lib devdopment. Before 
we start to go any further, a tutorial on better organization of code will be given. It will set up some organization 
parameters and will help you to make better and more manageable games. 


Tutorial 02: 


Organization in PW Lib Code 


This tutorial will focus on how to organize your code for a strikingly better management than the 
previous code from tutorial 01. As you might have noticed, the code is all in a solid block. What if | wanted to reuse 
scene 1? I would be locked into showing the advance arrow menu all the time! Doesn’t that sound bad? Yeah, it does. 
Also, let’s say you want to create another character. It would just bloat the game function. What if you would like to 
reuse the creation? It would be impossible. For that we have code organization. 

As a first step, we will break the game function into three new functions: game, setup and charcreation. 
This will make the code more reusable. N ow create both new functions just below the game function. 

On the setup function we will put the following: 
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[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


In the setup function, we will include both initializations, will run the charcreation function and define 
the game’s title. In the end we go to the run function. W e separate character creation from engine initialization. As we 
only have only function to initialize the backgrounds, it can go on the setup function. N ow to the charcreation function: 


[charcreation] 
runscript("pw_createema"); 


All new character creation calls will come here. This makes the function specific for the creation of 
characters. But what about the game function? W hat it will do? W dll, it will only be used to jump to the setup function, 
as is: 


[game] 
jumptoscript("setup"); 


With the game function reorganized, we now must do the same to the run function. T his reorganize will 
allow a better reuse of the scene itself if necessary. The function run will be broken into 3 parts too: run, enterscenel and 
scenel. H ere we have the enterscenel: 


[enterscenel ] 
runscript("pw_useowbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 
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H ere there is a change on the older tutorial code’s logic. As the advance arrow window is shown, we will 
only have the background on. A bit more like Phoenix W right Games do when starting. So in this function we set the 
background and show the advance arrow window, and jump to the scene itself: nothing special. N ow what happened to 
the run function? It is just ajump to the enterscenel function: 
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[run] 
jumptoscript("enterscenel"); 


With this method so far you can reuse all code without much hassle on “I didn’t expected to run that 
thing.” That makes code more dynamic. To go to scene 1 now you could only use the scenel function with a run or 
jump. You could even do some changes on this code and make the run function run enterscenel and jump to scenel, 
but in this case there isn’t much need. 


You may be thinking that “why we don’t just jump from setup to enterscenel function?”. There is a good 
reason for that, and later tutorials will be quite explanative about that. J ust make it a bit earlier in time: we can use run to 
initialize or run special stuff. 


O kay. And: what about scenel? It will contain the scene itself. There isn’t much mystery on this function. 
It is what’s left of the old run function: 


[scenel] 
runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
message("Y es!"); 

message("M y name is Ema Skyel"); 


Now as when you run the game, it wont show the advance arrow window flipping as you advance on 
Ema’s second line. This makes the game a lot more graceful too. The users outside may not seeit, but it can make your 
game easier to develop too. The result code you will get will be this: 


#include(pwlib/pwlib.hisl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
changetitle("PW Lib T utorial G ame"); 
jumptoscript("run"); 


[charcreation] 
runscript("pw_createema"); 


[run] 
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jumptoscript("enterscenel"); 


[enterscenel ] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 
runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
message("Y es!"); 

message("M y name is Ema Skyel"); 


Think ahead: make the code as useful and easy to expand as you can. Remember to make your games in a 
fashion that it looks graceful as possible. Now that this lesson is done, we can continue adding features to the “game”. 
Time to add more people to your talk! J ust Ema is getting boring. 
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Tutorial 03: 
Conversations 


It seems Ema is lonely talking by herself. Let’s add someone else to talk to her. Conversations are one of 
the most important things used in Phoenix Wright games. T his tutorial will cover how to make them. To talk to Ema, 
we will use Trucy and Phoenix. It’s a paradox, but for this tutorial game it isn’t an issue. So we will cover both in screen 
and out screen speakers (where the character on screen doesn’t lip-sync, so we will explain a bit more about lip-syncing. 
With this base you can start making long conversations. It’s one of the main features that you will need to get used to, 
and it isn’t hard. So let’s quit talking and start it already. 

We will first need to create Trucy (but not Phoenix, since there isn’t out of court sprites we will use. This 
will demonstrate how to make “conversations with the attorney”.). So under the charcreation we run Trucy’s creation 
function: 


runscript("pw_createtrucy"); 


And T rucy is ready for us to use. N ow all we will do is change the scenel function. We will rewrite the 
function to accommodate the talk. The three first lines are kept: 


runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 


And from there we begin setting the talk. But how we do that? Simple We only need to control three 
aspects: the current character graphic, the lip-sync control and the name box. As you can see the first lines already set lip- 
sync to enabled. Who will talk first? Ema, and she’s a character on screen, so we want her to lip-sync with the text. So we 
leave the lip-sync control as is. We could reorganize the code and put lip-sync as the third line, with no changes, but 
that’s an option of the programmer. As Ema will talk, she will use the lip-sync. 

So we set the character graphic. In this case: normal Ema, like the other tutorial. And since it’s Ema who’s 
talking, we set the name box to her: 


runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 


So, with those aspects set, we can put her lines. O ne note to take is that lip-sync is enabled only once, and 
won’t need to be enabled again for each talk/character change. It’s a global feature, which you enable and disable. As 
Phoenix talks, we will explain how to disable lip-sync to the character on screen. H ere is what Ema will say on this 
tutorial: 


message{"O h, hello."); 
message("M y name is Ema Skyel"); 
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Now Ema said her lines, and Trucy will take place. As she will speak too, and she’s on screen, we only 
need to change her name box and the character graphic for the new speaker. So, we will use Trucy’s normal pose: 


runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 


And set. N ow you can make T rucy talk what you want her to: 
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message("Oh, hello. M y nameis T rucy."); 
messagg "l'm a magician."); 


We can use any number of messages for the character to talk, and have infinite number of character 
changes. J ust follow the same rule: set the three needed controls if needed and use message to make them speak Out. Let’s 
make some more talking of both girls: 


runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message{"T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg "Scientifically soeaking...? \nH mmm..."); 
message(""But does magic needs to be \nproven?"); 


The order you set the name box, lip-sync and the character graphic is not fixed. Now let’s make Phoenix 
give a bit of his wisdom too. Differently from the girls, he isn’t on screen, so if he talks, lip-sync must be disabled, or if 
any character is on screen, it will lip-sync. And that isn’t what we want: 


runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 


Name box to Phoenix, as usual. He’s ready to talk now. Nothing different from what you did up until 
now. Just message commands: 


message(" (I better not try to argue \nin this one)"); 


This makes the talk dynamic, and you can just keep changing. Let’s put a bit more of talk: 


runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
message("W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone"); 
runscript("pw_setnameboxtophoenix"); 
message("Ah?"); 

messagg "W ell... Ah..."); 


Nothing different from what we did earlier. You can have easily other character than Phoenix who’s out 
screen to talk too. No restrictions on that. The character on screen is not connected with who talks, and that’s what you 
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do by controlling the three pillars of talking. You could have Ema say something with T rucy on screen, so you disabled 
the lip-sync and used Ema’s name box. T his technique is used into all conversations ahead. M ake sure you get the hang 
of it. It’s useful and doesn’t change in nature. 


TIP: All three controls are independent of each other. You can use this to control all aspects of talking. 


N ow takea look at the resulting file from this tutorial: 


#include(pwlib/pwlib.hisl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[run] 
jumptoscript("enterscenel"); 


[enterscenel] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 

runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
message("O h, hello."); 

message("M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 
messagg "O h, hello. M y nameis T rucy."); 
messagg "l'm a magician."); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
message("T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 
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messagg "Scientifically soeaking...? \nH mmm..."); 
message(""But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoeix"); 
message("(| better not try to argue \nin this one)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message "W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoeix"); 
message("Ah?"); 

messagg "W ell... Ah..."); 
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Tutorial 04: 


Adding Evidence And Profiles 


If you noticed when running the game: you have no evidence or profiles. It’s time to create them! T 0 do 
so, we will have to deal with AHLSL variables a bit. Let’s start this tutorial explaining the setvar AH LSL command, 
which will be the one we will use. 


The command setvar sets the value of a variable. It checks for conformity with types (you can’t put a 


number on a string variable), so be sure to check if the variable you’re using is the intended type. We have a lot more of 
commands involving variables, but we will enter into them later. 


Fast lesson given, we can begin. This tutorial will change the code greatly, so make sure to keep up to 
prevent going lost. N ot that we will enter a maze, but take care to not change incorrect parts of the code. N ot that it will 
be a hard to get tutorial, but the changes now will start making the game behave more like a Phoenix W right one. You 
will see how Tutorial 2’s changes will make the code a breeze to edit. 

Just as a start, the script will get two more functions: load and evidenceprofilecreation. The load one will 
be used to load needed graphics for the profiles, and evidenceprofilecreation will be used to create the evidences and 
profiles. N one note that needs to be given is that in PW Lib creating an evidence doesn’t give it to the player. You will 
need to explicitly give it (or take), but soon we will explain how to do that. 

So create load function between the setup and charcreation ones, and the evidenceprofilecreation between 
charcreation and run. With them added, you must edit the setup function to run both ones. Put load and 
evidenceprofilecreation just below the charcreations call: 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


And you end up with this new setup function. But, load what? I mages for the evidences and profiles! In 
this tutorial we will explain simple evidence, check-able evidence and profiles. But first let’s explain how it works. When 
you want to add evidence, you use this sequence of code: 


setvar([evidencenumber],900); 
setvar([evidencegfs],80901); 
setvar([evidencegfl],80901); 
setvar([evidencesup],0); 
setvar([evidencename],"Attorney's Badge"); 
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setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 
setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 


setvar([evidencenumber],900); defines the evidence code. In this example, it will be 900. It must be 
UNIQUE. 

setvar([evidencegfs],80901); defines the small evidence image (on the CR screen) to texture id 80901 
(witch will be explained how to load). 

setvar([evidencegfl],80901); is the same as above, but for the large evidence image (the one on detailed 
CR view). 

setvar([evidencesup],0); defines the number of pages on evidence Check. If it’s 0, there won’t be Check. 
On H ayase, we support only one page, so set this either to 1 or 0. 

setvar([evidencename], "Attorney's Badge"); defines the evidence name. 

setvar([evidencesdesc],"T ype: Other\n One of my possessions."); defines the short description for the 
evidence. 

setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); defines the 
long description (seen on the D etailed CR view). 

And runscript("createevidence"); creates the evidence in the “evidence pool” with the given parameters. 

For all evidences, you use the same block of code with different values. It doesn’t change. For profiles, it is 
similar: 
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setvar([profilenumber],800); 

setvar([profilegfs],90900); 

setvar([profilegfl],90900); 

setvar([profilename],"Ema Skye"); 

setvar([profilesdesc],"Age: 19\nG ender: Female"); 

setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 


You change evidence to profile. As you can see, there isn’t the setvar([profilesup],0); command, since 
profile doesn’t have check. Now let’s make some evidence and profiles. On the function evidenceprofilecreation we will 
create 3 evidences and 1 profile 


[evidenceprofilecreation] 

setvar([evidencenumber],900); 

setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename],"Attorney's Badge"); 

setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 

setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 

setvar([evidencename],"G un"); 

setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor V on Karma."); 
setvar([evidenceldesc],"T he murder weapon. \nlt was shot once."); 
runscript("createevidence"); 
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setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl],80902); 

setvar([evidencesup], 1); 

setvar([evidencename],"T rucy G S4 Promo"); 
setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 

setvar([evidencestex], 7000); 

runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 

setvar([profilegfs],90900); 

setvar([profilegfl],90900); 

setvar([profilename],"Ema Skye"); 

setvar([profilesdesc],""Age: 19\nG ender: Female"); 

setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 


As you can see, Trucy GS4 Promo evidence will have Check. N ow that we created out evidence and 
profile, we need to load the necessary textures for the evidence and profile graphics. That’s what we will do on the load 
function. 

To load a texture on AIGE, we use the loadtexture command. It iss smple command: 


loadtexture(80900,"PW /evidence/gun.png"); 


W here the number is the ID of the texture and the text (between “”) is the path to the file we want to 
load under that ID. Also the ID must be UNIQUE. To prevent issues with the images loaded by PWLib, we 
recommend using numbers higher than 70000. Also the paths can be relative to where AIGE.exe is placed. For the 
evidence we will use the evidence images that come with PW Lib. They are on the PW /evidence folder: 


loadtexture{80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture(80902,"PW /evidence/photo.png"); 


And PW Lib also comes with profiles too. They are at PW/profile: 


loadtexture(90900,"PW /profile/ema.png"); 


As you can see, the IDs match the ones we used on evidencegfs, evidencegfl, profilegfs and profilegfl 
definition lines for the evidences and profile. That’s what we wanted. Changing numbers change the graphic. But what 
about the evidencesup one that isn’t 0? We must load an image for it under ID 70000, or the id we want to use for the 
evidence page. But we must set the evidence page to use the graphic: 


setvar([evidencestex], 7000); 
runscript("setevidencepagesimple"); 


This section sets the page 0 (first page) using the simple version of the setevidencepage function. N ow 
back to loading the graphic. For that you can use a folder called cust, from Custom (or create a folder under PW with 
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other name, or even a “PWCustom” or other name folder in the same folder as AIGE.exe) to put custom data (images 
for example). T he tutorials have an image named trucygs4.jpg on cust and that’s the one we will be using. So let’s load it: 


loadtexture{ 70000," cust/trucygs4.jpg"); 


And you're set with evidence and profile creating. Your load file will be like this: 
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[load] 

loadtexture(80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture(80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/ana.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 


But still even if you save and test the game, no evidence and no profiles. What gives? That’s quite 
expected. C reating evidence doesn’t give them to the player. To give an evidence to the player: 


setvar([evidencenumber],900): 
runscript("addevidence"); 


Yes, you use the evidencenumber variable again. Set it to the evidence code you want to give to the player, 
and call addevidence. There you go: the player just got evidence id 900 (the Attorney’s 
Badge)! But it won’t show any animation or such, it will just add it there. For profiles: 


setvar([profilenumber],800); 
runscript("addprofile"); 


Same as evidence, but changing to profile. But where to add those commands? W e want the attorney to 
have the items from start. Remember the run function? W e will put them there like this: 


[run] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([profilenumber],800); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


And that’s your run function. Wait? Only two evidences? We will change the talk to add the evidence in 
mid-game. J ust below this line on scenel: 


message("I'm a magician."); 


W e will add: 


setvar([evidencenumber],902); 
runscript("addevidence"); 
message(""T his photo proves it."); 
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This gives a new line to Trucy, and adds the evidence 902 (The T rucy GS4 Promo). N ow as you test the 
script, you will notice that you will get a new evidence mid-game! T his works the same for profiles. But what if | want to 
TAKE aprofile or evidence from the player? W e use this: 
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setvar([evidencenumber],902); 
runscript("takeevidence"); 


Change from add to take, that simple The same with profiles, of course H ere is this tutorial’s resulting 
code: 


#include(pwlib/pwlib.hlsl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[load] 

loadtexture(80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture(80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/ema.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[evidenceprofilecreation] 

setvar([evidencenumber],900); 

setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename]," Attorney's Badge"); 
setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions." ); 
setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 

setvar([evidencename],"G un"); 
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setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor V on Karma."); 
setvar([evidenceldesc],"T he murder weapon.\nlt was shot once."); 
runscript("createevidence"); 

setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl],80902); 

setvar([evidencesup],1); 

setvar([evidencename],"T rucy G S4 Promo"); 

setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 

setvar([evidencestex], 7000); 

runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 

setvar([profilegfs],90900); 

setvar([profilegfl],90900); 

setvar([profilename],"Ema Skye"); 

setvar([profilesdesc],"Age: 19\nG ender: Female"); 

setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 


[run] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([profilenumber],800); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


[enterscenel] 
runscript("pw_useowbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 
runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
messagg "O h, hello."); 

messagg "M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 
message("O h, hello. M y name is T rucy."); 
messagg "l'm a magician."); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
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message("T his photo proves it."); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message{"T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg "Scientifically soeaking...? \nH mmm..."); 
message{"But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 

message("(| better not try to argue \nin this one)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
message("Ah?"); 

messagg "W ell... Ah..."); 


The code grew quite a bit now, huh? T his part really grows basic code up, because of the definitions, but 
it isa one-way, single definition, so you won’t need to recreate the objects all the time. 

And with this, you can now create, add and take evidences and profiles. N ow let’s give a bit of effect into 
it. The evidence add effect is coming up! 


Tutorial 05: 


Evidence Add Effect 


Evidence Add Effect gives a bit more of life into the game, and it easy to use. Now let’s make the evidence 
giving that T rucy did a bit more lively. T o use the evidence add effect, we use this format: 
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setvar([evidencenumber],902); 

setvar([pw_headeviaddmsg],""); 

setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 


W e set the evidencenumber we want the effect to point (902, the promo evidence). The head and tail 
messages and run the pw_startevidenceadd function. The head message will appear in fro of the evidence name and the 
tail just after:<H ead message> evidencename <T ail message>. In this case, we will get: Trucy GS4 Promo was added to 
the Court Record. Play with it to suit your ideas. If you’re going to use a default message for all your game, you can set 
the tail and head messages once. Now let’s add it to our code. For that I’ll change a bit of the code order. First, this part: 


message("|'m a magician."); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
message("T his photo proves it."); 


Will be changed into: 


message("I'm a magician."); 
message("T his photo proves it."); 
setvar([evidencenumber],902); 
runscript("addevidence"); 


Just a simple order change. And just below the addevidence call, we put this: 


setvar([evidencenumber],902); 

setvar([pw_headeviaddmsg],""); 

setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 


And now you have evidence add working. Simple as that, you can use it on all evidence you want, but 
remember: add the evidence to the player first!Also n a side note: you could remove the second 
setvar([evidencenumber],902); (the one above setvar([pw_headeviaddmsg],""); just for one less command for AIGE to 
process. Not that it will change anything, but that’s your decision as a programmer. 

As usual, here is the tutorial’s code: 
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#include(pwlib/pwlib.hlsl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[load] 

loadtexture(80900,"PW /evidence/gun.png"); 
loadtexture{80901,"PW /evidence/lawyer badge.png"); 
loadtexture(80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/ena.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[evidenceprofilecreation] 

setvar([evidencenumber],900); 

setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename],"Attorney's Badge"); 

setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 
setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 

setvar([evidencename],"G un"); 

setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor Von Karma."); 
setvar([evidenceldesc],"T he murder weapon. \nlt was shot once."); 
runscript("createevidence"); 

setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl],80902); 

setvar([evidencesup], 1); 

setvar([evidencename],"T rucy GS4 Promo"); 
setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 
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setvar([evidencestex], 7000); 
runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 
setvar([profilegfs],90900); 
setvar([profilegfl],90900); 
setvar([profilename],"Ema Skye"); 
setvar([profilesdesc],"Age: 19\nG ender: Female’); 


setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 


runscript("createprofile"); 


[run] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([evidencenumber],800); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


[enterscenel] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 

runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
message("O h, hello."); 

message("M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 
messagg "O h, hello. M y nameis T rucy."); 
messagg "l'm a magician."); 

message "T his photo proves it."); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
setvar([evidencenumber],902); 
setvar([pw_headeviaddmsg],""); 
setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
message{"T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 
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message{" Scientifically speaking...? \nH mmm..."); 
message(""But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
message("(| better not try to argue \nin this one)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message "W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
message("Ah?"); 

messagg "W ell... Ah..."); 


Concluding one more feature, let’s go a bit more ahead. Let’s use some balloons so we can give a more 
“Phoenix Wright” feel to the game. 


Tutorial 06: 


U sing D efault Balloons 


The balloons for Objection, Take That and Hold It are important on Phoenix Wright games. Adding 
them to your game in PW Lib is simple and differently from the evidence add require only 1 command to do. The 
command for T ake T hat is: 
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runscript("pw_raisetakethat"); 


And for O bjection: 


runscript("pw_raiseobjection"); 


And for H old It: 


runscript("pw_raiseholdit"); 


But as we use them, we don’t automatically have sound. You will have to make AIGE play the sound (it 
isn’t complicated, and will be explained in a future tutorial). O ne note is that you might want to hide the M essage Box 
to use the balloon itself. Since you know how to show the message box, all you need to know is how to hide it: 


runscript("pw_hidemessagebox"); 


And you have the effect like on Phoenix Wright. In our tutorial game, we will hide the message box, use 
the balloon and show the M essage B ox again: 


runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 
runscript("pw_showmessagebox"); 


Simple and easy, minimal setup. And we will put it just below the message{"This photo proves it."); 
command on the scenel function. T his concludes this small tutorial, and we end up with this resulting script: 


#include(pwlib/pwlib.hlsl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 
runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
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runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[load] 

loadtexture(80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture{80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/ena.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[evidenceprofilecreation] 

setvar([evidencenumber],900); 

setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename],"Attorney's Badge"); 

setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 
setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 

setvar([evidencename],"G un"); 

setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor V on Karma."); 
setvar([evidenceldesc],"T he murder weapon. \nlt was shot once."); 
runscript("createevidence"); 

setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl ],80902); 

setvar([evidencesup],1); 

setvar([evidencename],"T rucy G S4 Promo"); 
setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 

setvar([evidencestex], 7000); 

runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 
setvar([profilegfs],90900); 
setvar([profilegfl],90900); 
setvar([profilename],"Ema Skye"); 
setvar([profilesdesc],"Age: 19\nG ender: Female"); 
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setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 


[run] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([evidencenumber],800); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


[enterscenel ] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 

runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("O h, hello."); 

message("M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg "O h, hello. M y nameis T rucy."); 
messagg "l'm a magician."); 

message("T his photo proves it."); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 
runscript("pw_showmessagebox"); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
setvar([evidencenumber],902); 
setvar([pw_headeviaddmsg],""); 
setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message{"T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg" Scientifically soeaking...? \nH mmm..."); 
message("But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
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message("(| better not try to argue \nin this one.)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message "W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoeix"); 
message("Ah?"); 

messagg "W ell... Ah..."); 


Okay, now as you might have noticed, we go directly toward the game No New Game screen. Next 
tutorial will show you how to use the N ew Game screen in your games. 


Tutorial 07: 
Adding the N ew Game Screen 


W ell, now as you can see, our code is quite organized, and so the changes we will introduce here will be 
made a lot easier. To add the N ew Game Screen, we will need to change a bit of stuff. 

First w will need to break the run function into two new functions: the run and the casestart ones. T he 
casestart ones will include the original run function’s body: 
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[casestart] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([profilenumber],800); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


W ith no changes. The new run function is empty now, but it will be there that we will put the new game 
screen. First of all, we will need to set the game’s title screen. To do that, we can use one of AIGE’s features: the bg 
(background). PW Lib setups it to be the size of the top of the screen by default, so all you will need is to set an image for 
it. Its size is 256x192 pixels, so we will use an image of such size. 

Once you have the image that suits your game (the tutorial has one already done for it), you need to set 
the bg to useit: 


setbg(70010); 


Now all you need to do is to load an image to a texture id 70010 and the bg will be that image. But let’s 
finish the run function first. N ow comes the important part: show the N ew Game Screen itself: 


runscript("pw_showmain"); 
waitresponse(); 
runscript("pw_hidemain"); 


And then jump to the casestart function, so your modified run function is completed. It will look like 
this: 


[run] 

setbg(70010); 
runscript("pw_showmain"); 
waitresponse(); 
runscript("pw_hidemain"); 
jumptoscript("casestart"); 


tf FF 


And you finished with the modifications on the run function. N ow you need to load the image on the 
correct id. As usual, loadtexture command: 


loadtexture(70010,"cust/PW LibT utoM ain.png"); 
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That will be placed on the load function. As usual we used the cust folder on AIGE.exe’s folder. O nce 
you do that, the code is completed. Your game now uses the N ew Game Screen! H ere is the working code of this 
tutorial: 


#include(pwlib/pwlib.hIsl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[load] 

loadtexture(80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture(80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/ena.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 
loadtexture{70010,"cust/PW LibT utoM ain.png"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[evidenceprofilecreation] 

setvar([evidencenumber],900); 

setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename],"Attorney's Badge"); 
setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 
setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 
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setvar([evidencename],"G un"); 

setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor V on Karma."); 
setvar([evidenceldesc],"T he murder weapon. \nlt was shot once."); 
runscript("createevidence"); 

setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl],80902); 

setvar([evidencesup], 1); 

setvar([evidencename],"T rucy G S4 Promo"); 
setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 

setvar([evidencestex], 7000); 

runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 

setvar([profilegfs],90900); 

setvar([profilegfl],90900); 

setvar([profilename],"Ema Skye"); 

setvar([profilesdesc],"Age: 19\nG ender: Female"); 

setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 


[run] 

setbg(70010); 
runscript("pw_showmain"); 
waitresponse(); 
runscript("pw_hidemain"); 
jumptoscript("casestart"); 


[casestart] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([profilenumber],800); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


[enterscenel] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 
runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
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messagg "O h, hello."); 

messagg "M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg "O h, hello. M y nameis T rucy."); 
messagg "l'm a magician."); 

message("T his photo proves it."); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 
runscript("pw_showmessagebox"); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
setvar([evidencenumber],902); 
setvar([pw_headeviaddmsg],""); 
setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message("T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

message{" Scientifically soeaking...? \nH mmm..."); 
message("But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
message("(| better not try to argue \nin this one)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone"); 
runscript("pw_setnameboxtophoenix"); 
message("Ah?"); 

message("W ell... Ah..."); 


O kay, now let’s start with something a bit harder 


: evidence and profile present! 


Tutorial 08: 
Presenting Evidence and Profiles 


One of the major aspects of a Phoenix W right game is to be able to present evidence and profiles to point 
out contradictions. W e have both added, so we must now learn how to present them. 

The mechanics into presenting evidence can be complicated for some beginners, but with practice and 
testing this barrier can be easily broken. We will enter a bit more into AHLSL’s programming to develop the presenting 
evidence and profiles. T hose familiar with programming will most likely get a head start on this aspect of the tutorial. 

Before we begin, we will add more profiles to the game. Exactly we will add one more: Trucy’s. As YOU 
already know how to do that: 
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setvar([profilenumber],801); 
setvar([profilegfs],90901); 
setvar([profilegfl],90901); 
setvar([profilename],"T rucy W right"); 
setvar([profilesdesc],"Age: 15\nG ender: Female"); 
setvar([profileldesc],"A cheerful magician girl."); 
runscript("createprofile"); 


loadtexture(90901,"PW /profile/minuki.png"); 


And we add it on the casestart function as usual: 


setvar([profilenumber],801); 
runscript("addprofile"); 


N ow that we have the new profile added, we can begin with the presenting. Presenting uses a basic format 
just like other features, but just a bit larger in commands. W e use three functions to make present: one main function to 
control and configure the present, one for the response if the presented evidence correct, and one for the response if the 
presented evidence is wrong. W e have more than one evidence present-able, so we make one more correct and one more 
wrong function for it, if needed. Also, you can reuse the function from other evidence if you like. In AIGE that is 
Possible, as those functions are not forcefully directed to one point of usage. It’s all up to the programmer to make what 
he needs in that moment. 

Now enough chatting, and come coding. First we create the three needed functions. In this case: 
presenttrucyevidence, presenttrucyevidencecorrect and presenttrucyevidencewrong: 


[presenttrucyevidence] 
[presenttrucyevidencecorrect] 


[presenttrucyevidencewrong] 


AA i ]_ 


We place gen just below the scenel function. The name of the functions can be anything. But bear in 
mind to name them accordingly for later reference if needed. From scenel function we will jump to the 
presenttrucyevidence function, so don’t forget to add it! 

The presenttrucyevidence will be your “present control function” where we will define how the present 
will be and configure it. H ere is the body of the function: 
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definevar([signal],"int"); 

runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 

runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 

runscript("pw_hidemessagebox"); 

runscript("pw_raisetakethat"); 

wait(6); 
if(<compare([currentitemcode],"equal",902)>,<umptoscript("presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


The “if” was just too big to fit on one single line, so it is broken into two. In the actual script, the 
command must be on a single line. 

Now let’s explain each command, one by one. Some of them you might already know, so let’s explain the 
new one by one: 


definevar([signal],"int"); 


This creates a variable with name signal of type int (integer, accepts only Integer [Z] numbers. Eg: 1, - 
400, 641, 0). We will use it for a following command. If you have difficulty understanding this now, don’t worry, all 
presents will use this same command, so you can pass it on, for now. 


runscript("pw_setnameboxtonoone’); 


This sets the name box to no one (disables it). 


messageauto("(Show what proves that T rucy is \na magician!)"); 


A message, but a bit different than the usual message command. The messageauto command. doesn’t 
“wait” for you to advance, but instead keeps ahead as it finishes drawing. That is what we want now. You will see more 
of it when we start talking about special message types (like Old Bag’s fast continuous blabbering in some PW games). 


runscript("pw_forcepresent"); 


This is the function that will open the Court Record with Present button and force you to present 
something. As default, you can present evidence and profiles. 


waitsignal("advance" [signal ]); 


This waitsignal command is just like the waitresponse command we used earlier, but with a difference. To 
explain it fully we would need to get deeper into AHLSL, what isn’t needed right now. 


Af ] 


The waitsignal command waits for a signal sent from other script, with the name it has on the parameter 
(advance in this case). The signal also comes with a value that will be placed on the signal variable (or the one you place 


on the second parameter. 


The next two commands are known by you already, so let’s skip them. 


wait(6); 


The wait command is new to you, so it deserves some explanation. It makes the game wait for a certain 
number of frames (in time it would be n/60 seconds). In this case we make AIGE wait 6/60 seconds, or 0.1 second. | use 
that to make a bit more of distance between the balloon and the if control. (as we won’t get any wait ahead). 

W ith that we come to the “if” command, which will have a bit more of explanation: 


if(<compare([currentitemcode],"equal",902)>,<umptoscript("presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


The if command works with three parameters. Its format is like this: 


if(condition,condition_truecondition_false); 


The condition is a command (so placed inside <>) and will result either true or false. If it is true, it will 
execute the command on the condition_true, else it will execute the command on condition_false. For the condition 
function, we will use the compare command. It is one of the AH LSL commands that return true or false. T here are other 
commands like this, but let’s stick to what we need now. 

The compare command by itself has three parameters. In this case we will use the first as a variable 
(currentitemcode one) that holds the last selected item on the Court Record (as you clicked Present). The next parameter 
is the type of comparison we are making: equal. And the last is the compare target (parameterl is parameter2 to 
parameter3). So in this case we have: variable currentitemcode is equal to 902?. That’s what we are asking for compare to 
do. Is it equal or not? It depends on what the player selected while presenting. If it is, we want to do something. If not, 
we want to do something else. In this case, we want to jump to the presenttrucyevidencecorrect if it is true, and to the 
presenttrucyevidencewrong if it is false. So we put them on the accordingly correct compare targets. In short: 


> Condition = <compare([currentitencode],"equal",902)> 
> Condition_true =<umptoscript("presenttrucyevidencecorrect")> 
> Condition_false = sumptoscript(" presenttrucyevidencewrong")> 


W e expect the player to show us the evidence “Trucy GS4 Promo”. In your game you can change the 902 
to the id of the evidence or profile you want the player to present. To use multiple presentable possibilities, there is a 
change you will need to do. The condition_false would to be changed to the null() command. 

The null command does nothing, which is what we want. A multiple presentable situation would be like 
this: 


if(<compare([currentitemcode],"equal",10)>,<umptoscript("presentl0c")>,<null()>); 
if(<compare([currentitemcode]," equal", 11)>,<umptoscript("presentl1c")>,<null()>); 
if(<compare([currentitemcode],"equal",12)>,<umptoscript("presentl2c")>,<umptoscript(wrongpresent) >); 


In this case if you don’t present evidence 10, 11 or 12 you will jump to the wrongpresent function. 
For the correct and wrong function of our game, nothing special, just normal talk control: 


Af s ] 


PWLib in aNutshdl 


IPN Ne ULQIIMd 


[presenttrucyevidencecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
message "Y ou may be right..."); 
message{"But who gave you this?"); 
jumptoscript("presenttrucyprofile’); 


[presenttrucyevidencewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 

message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message("W hat is this supposed to mean \nanyway?"); 
jumptoscript("scenel"); 


The wrong one will return to the sceen1 function, so no comments. But the correct function will jump to 
a function we didn’t define yet. Yes, it is new present, but with something different. You can control what to present: 
profile and evidence, only profile or only evidence! T ake a look at the second present code: 


[presenttrucyprofile] 

definevar([signal],"int"); 
runscript("pw_setnameboxtonoone’); 
runscript("setlipsynctonoone’); 
messageauto("(Show who gave you this \nphoto!)"); 
setvar([pwonetypepresent], 2); 
runscript("pw_forcepresent"); 
waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 

wait(6); 

if(<compare([currentitemcode], "equal" 801)>,<umptoscript("presenttrucyprofilecorrect")>,<umptoscript("presenttrucy 
profilewrong")>); 


[presenttrucyprofilecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 

message("H mmm, that is interesting..."); 
jumptoscript("scenel"); 
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[presenttrucyprofilewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 

message("I'm not sure about this, you \nknow...!"); 
jumptoscript("scenel"); 
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Same as out other code, it is just different by one little line 


setvar([pwonetypepresent], 2); 


Setting this variable to value 2 makes the present system limit itself to profiles. Setting to value 1 limits 
the present system to evidence. 0 is the default, and as you present, no matter the value set, it is reset to 0, so no need to 
set it to 0 in the next present. 

And this concludes our tutorial on presenting. H ere is the complete code for this tutorial: 


#include(pwlib/pwlib.hlsl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[load] 

loadtexture{80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture{80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/emapng"); 
loadtexture(90901,"PW /profile/minuki.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 
loadtexture{70010,"cust/PW LibT utoM ain.png"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[evidenceprofilecreation] 
setvar([evidencenumber],900); 
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setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename], "Attorney's Badge"); 

setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 
setvar([evidenceldesc],"It's my all important badge\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 

setvar([evidencename],"G un"); 

setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor V on Karma."); 
setvar([evidenceldesc],"T he murder weapon. \nlt was shot once."); 
runscript("createevidence"); 

setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl],80902); 

setvar([evidencesup],1); 

setvar([evidencename],"T rucy G S4 Promo"); 
setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 

setvar([evidencestex], 7000); 

runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 
setvar([profilegfs],90900); 
setvar([profilegfl],90900); 
setvar([profilename],"Ema Skye"); 
setvar([profilesdesc],"Age: 19\nG ender: Female"); 
setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 
setvar([profilenumber],801); 
setvar([profilegfs],90901); 
setvar([profilegfl],90901); 

setvar([profilename],"T rucy W right"); 
setvar([profilesdesc],"Age: 15\nG ender: Female’); 
setvar([profileldesc],"A cheerful magician girl."); 
runscript("createprofile"); 


[run] 

setbg(70010); 
runscript("pw_showmain"); 
waitresponse(); 
runscript("pw_hidemain"); 
jumptoscript("casestart"); 


[casestart] 
setvar([evidencenumber],900): 
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runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([profilenumber],800); 
runscript("addprofile"); 
setvar([profilenumber],801); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


[enterscenel] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 

runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("O h, hello."); 

message("M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg "O h, hello. M y nameisT rucy."); 
messagg "l'm a magician."); 

messagg "T his photo proves it."); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 
runscript("pw_showmessagebox"); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
setvar([evidencenumber],902); 
setvar([pw_headeviaddmsg],""); 
setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message{"T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

messagg "Scientifically soeaking...? \nH mmm..."); 
message("But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone"); 
runscript("pw_setnameboxtophoenix"); 
message("(| better not try to argue \nin this one)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
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runscript("pw_setnameboxtoema"); 
message "W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
message("Ah?"); 

message("W ell... Ah..."); 
jumptoscript("presenttrucyevidence"); 


[presenttrucyevidence] 

definevar([signal],"int"); 

runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 
runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 

wait(6); 

if(<compare([currentitemcode]," equal" ,902)>,<umptoscript(" presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


[presenttrucyevidencecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
messagg "Y ou may be right..."); 
message{"But who gave you this?"); 
jumptoscript("presenttrucyprofile’); 


[presenttrucyevidencewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 

message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message("W hat is this supposed to mean \nanyway?"); 
jumptoscript("scenel"); 


[presenttrucyprofile] 

definevar([signal],"int"); 
runscript("pw_setnameboxtonoone’); 
runscript("setlipsynctonoone’); 
messageauto("(Show who gave you this \nphoto!)"); 
setvar([pwonetypepresent], 2); 
runscript("pw_forcepresent"); 
waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 
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runscript("pw_raisetakethat"); 

wait(6); 

if(<compare([currentitemcodel], "equal" ,801)>,<umptoscript("presenttrucyprofilecorrect")>,<umptoscript("presenttrucy 
profilewrong")>); 


[presenttrucyprofilecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 

message("H mmm, that is interesting..."); 
jumptoscript("scenel"); 


[presenttrucyprofilewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 

message("I'm not sure about this, you \nknow...!"); 
jumptoscript("scenel"); 
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Now it’s time to work out with Examine. It isn’t harder than Present, but uses some new AHLSL 
commands. 
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Tutorial 09: 
Examining Photos and Places 


Examining is one of the most important features of Phoenix Wright games. But it isn’t hard to deploy on 
PW Lib. It follows the same idea of Presenting, so you may not have issues adding this functionality in your game It 
works the same way as Presenting, so here is the control function for the Examine 


[simpleexamine] 
runscript("pw_showmessagebox"); 
setbuttonarea("pw_examineareal",157,302,81,23); 
setvar([pw_examinemaxplaces],1); 
runscript("pw_showtouchananswe™); 
messageauto("So, what is wrong in this place?"); 
runscript("hideowmenu"); 
runscript("pw_showspecialexamine"); 
runscript("pw_waitexaminetouch"); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 
runscript("pw_hidetouchananswer"); 
if(<compare{[pw_examinearea]," equal" ,1)>,<qumptoscript("simpleexaminecorrect")>,<umptoscript("simpleexaminewro 
ng")>); 


It looks a lot like the present one. Of course we have differences, and we will explain those. O nly what is 
new will be explained. So, let’s begin: 


setbuttonarea("pw_examineareal",157,302,81,23); 


This will define one “clue area” for the player to examine. This can be tricky at first, but with time you 
will easily get the hand of it. T he area is a rectangle that starts on point 157,302 (referencing to the top left corner of the 
screen as 0,0) and have width and height of 81,23. The lower screen starts at 0,192: so it’s better to keep your Y higher 
than 192. Try always to keep the rectangle inside the “examinable area”. It avoids problems. 

Also you can define up to 10 areas. To define a new area, you use a different pw_examinearea object. We 
are using object 1. To use object 2, just change 1 to 20, like this: 


setbuttonarea("pw_examinearea2",157,302,81,23); 


You can go up to 10 with this. Remember to use 1 then 2 then 3, and so on. T his is because the next line 
will define how many objects you will use: 


setvar([pw_examinemaxplaces],1); 
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This defines how many objects (areas) will be used. So if you put 1, it will use area 1 only. If you put 4, it 
will use areas 1, 2, 3 and 4. 


runscript("pw_showtouchananswer"); 


Now we show the “Touch an Answer” box that appears below the Message Box. This is optional. 
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runscript("hideowmenu"); 


This hides the current lower screen window (menu), no matter which one is there. We do this since we 
will change it to the Examine. 


runscript("pw_showspecialexamine'); 


Shows the Examine lower screen. This is like the force present one for presenting. It is called special 
because it is a present special for “object/photo/place examination”, while the normal one is for the investigation. 


runscript("pw_waitexaminetouch"); 


It waits for an examine touch -> present action. It is mostly like the waitsignal holder we had earlier. 


runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 


Once the present had been done, we can reopen the screen that was before In this case the advance 
arrow one. 


runscript("pw_hidetouchananswer); 


It hides the “Touch an Answer” and reverts the M essage Box to its correct place. 


if(<compare{[pw_examinearea]," equal" ,1)>,<qumptoscript("simpleexaminecorrect")>,<umptoscript("simpleexaminewro 
ng")>); 


The same if as on present. But this time we check for pw_examinearea, and for values of 1 to 10. The 
variable holds the area the user was over when clicking Present. 0 means no area was selected, while 1 to 10 was one of 
the areas you defined. J ust process as you did with the present. 

As you can see, this example used the current background. But what about custom images, like photos? 
For that we use this: 


setvar([pw_examineusecustom],1); 
setvar([pw_examinecustomphoto],8000); 


Before we call the Examine window. The first line enables custom examine and the second defines the 
image that will be used (the one in texture id 800). But remember to do this: 


setvar([pw_examineusecustom],0); 
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To disable it as soon as the Examine is done, so you keep the custom examine disabled, like in this 
example: 
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[judgepresentevidphoto] 
runscript("pw_showmessagebox"); 
messageauto("So, what proves the good \nrdlationship of M aya and \nPearl in this photo?"); 
setbuttonarea("pw_examineareal",157,302,81,23); 
runscript("pw_showtouchananswer"); 
setvar([pw_examineusecustom],1); 
setvar([pw_examinecustomphoto],8000); 
runscript("hideowmenu"); 
runscript("pw_showspecialexamine'); 
runscript("pw_waitexaminetouch"); 
runscript("pw_hidetouchananswer"); 
setvar([pw_examineusecustom],0); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 


It changes a bit of the order for the messageauto, but at this point you already knew it is possible. In this 
example, the text completes then we see the “Touch an Answer”. Experiment with ordering to get different results, but 
remember that order is important for some commands (like you need to configure the areas before you enter the 
Examine screen, and that you NEED to wait for examine touch only after showing the Examine. At first try to keep up 
with examples. 

H ereis the correct and wrong functions for the tutorial’s Examine: 


[simpleexaminecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
runscript("pw_setnameboxtonoone’); 
message("H ere!"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 
message("H mm, yeah, it looks \ninteresting...!"); 
jumptoscript("scenel"); 


[simpleexaminewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
runscript("pw_setnameboxtonoone’); 
message("T his is what proves... er..."); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 
message("I'm not sure about this, you \nknow...!"); 
jumptoscript("scenel"); 


N othing new here, just the usual scene-talk. H ere is the tutorial complete code: 
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#include(pwlib/pwlib.hisl) 


[tutomain] 
jumptoscript("setup"); 


[setup] 

runscript("pw_initpwlib"); 
runscript("pw_initpwbgs"); 
runscript("charcreation"); 
runscript("load"); 
runscript("evidenceprofilecreation"); 
changetitle("PW Lib T utorial Game"); 
jumptoscript("run"); 


[load] 

loadtexture{80900,"PW /evidence/gun.png"); 
loadtexture(80901,"PW /evidence/lawyer badge.png"); 
loadtexture(80902,"PW /evidence/photo.png"); 
loadtexture(90900,"PW /profile/ema.png"); 
loadtexture(90901,"PW /profile/minuki.png"); 
loadtexture{ 70000," cust/trucygs4.jpg"); 
loadtexture{70010,"cust/PW LibT utoM ain.png"); 


[charcreation] 
runscript("pw_createema"); 
runscript("pw_createtrucy"); 


[evidenceprofilecreation] 

setvar([evidencenumber],900); 

setvar([evidencegfs],80901); 

setvar([evidencegfl],80901); 

setvar([evidencesup],0); 

setvar([evidencename],"Attorney's Badge"); 
setvar([evidencesdesc],"T ype: O ther\n O ne of my possessions."); 
setvar([evidenceldesc],"It's my all important badge.\nIt shows that I'm a defense attorney."); 
runscript("createevidence"); 

setvar([evidencenumber],901); 

setvar([evidencegfs],80900); 

setvar([evidencegfl],80900); 

setvar([evidencesup],0); 

setvar([evidencename],"G un"); 

setvar([evidencesdesc],"T ype: W eapons\n Submitted as evidence\n by Prosecutor V on Karma."); 
setvar([evidenceldesc],"T he murder weapon. \nlt was shot once."); 
runscript("createevidence"); 

setvar([evidencenumber],902); 

setvar([evidencegfs],80902); 

setvar([evidencegfl],80902); 

setvar([evidencesup], 1); 

setvar([evidencename],'"T rucy G S4 Promo"); 
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setvar([evidencesdesc],"T ype: Photo\nR eceived from T rucy W right."); 
setvar([evidenceldesc],"A promo photo of Gyakuten Saiban \n4."); 
runscript("createevidence"); 

setvar([evidencestex], 7000); 

runscript("setevidencepagesimple"); 


setvar([profilenumber],800); 
setvar([profilegfs],90900); 
setvar([profilegfl],90900); 
setvar([profilename],"Ema Skye"); 
setvar([profilesdesc],"Age: 19\nG ender: Female"); 
setvar([profileldesc],"An energetic girl that wants to be a \nforensic detective."); 
runscript("createprofile"); 
setvar([profilenumber],801); 
setvar([profilegfs],90901); 
setvar([profilegfl],90901); 
setvar([profilename],"T rucy W right"); 
setvar([profilesdesc],"Age: 15\nG ender: Female"); 
setvar([profileldesc],"A cheerful magician girl."); 
runscript("createprofile"); 


[run] 

setbg(70010); 
runscript("pw_showmain"); 
waitresponse(); 
runscript("pw_hidemain"); 
jumptoscript("casestart"); 


[casestart] 
setvar([evidencenumber],900); 
runscript("addevidence"); 
setvar([evidencenumber],901); 
runscript("addevidence"); 
setvar([profilenumber],800); 
runscript("addprofile"); 
setvar([profilenumber],801); 
runscript("addprofile"); 
jumptoscript("enterscenel"); 


[enterscenel] 
runscript("pw_usepwbgcourthall"); 
runscript("pw_showadvarrowmenu"); 
jumptoscript("scenel"); 


[scenel] 
runscript("setlipsynctochar"); 
runscript("showpwchar"); 
runscript("pw_showmessagebox"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
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message("O h, hello."); 

message("M y name is Ema Skyel"); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

message("O h, hello. M y name is T rucy."); 
messagg "l'm a magician."); 

message("T his photo proves it."); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 
runscript("pw_showmessagebox"); 
setvar([evidencenumber],902); 
runscript("addevidence"); 
setvar([evidencenumber],902); 
setvar([pw_headeviaddmsg],""); 
setvar([pw_taileviaddmsg]," was added\nto the Court Record."); 
runscript("pw_startevidenceadd"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message{"T hat's cool! But scientifically \nspeaking..."); 
message("M agic doesn't exist."); 
runscript("pw_setnameboxtotrucy"); 
runscript("pw_enabletrucynormal"); 

message{" Scientifically soeaking...? \nH mmm..."); 
message(""But does magic needs to be \nproven?"); 
runscript("setlipsynctonoone’); 
runscript("pw_setnameboxtophoenix"); 
message("(| better not try to argue \nin this one)"); 
runscript("setlipsynctochar"); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("W hat do you think, M r. \nW right?"); 
runscript("setlipsynctonoone"); 
runscript("pw_setnameboxtophoenix"); 
message("Ah?"); 

message("W ell... Ah..."); 
jumptoscript("presenttrucyevidence"); 


[presenttrucyevidence] 

definevar([signal],"int"); 

runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 
runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 

wait(6); 
if(<compare([currentitemcode],"equal",902)>,<umptoscript("presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


Af ss [| 


PWLib in aNutshdl | 


IPN NE UIQIWMd 


[presenttrucyevidencecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
messagg "Y ou may be right..."); 
message{"But who gave you this?"); 
jumptoscript("presenttrucyprofile"); 


[presenttrucyevidencewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 

message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 

message("W hat is this supposed to mean \nanyway?"); 
jumptoscript("scenel"); 


[presenttrucyprofile] 

definevar([signal],"int"); 
runscript("pw_setnameboxtonoone’); 
runscript("setlipsynctonoone"); 
messageauto("(Show who gave you this \nphoto!)"); 
setvar([pwonetypepresent], 2); 
runscript("pw_forcepresent"); 
waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 

wait(6); 

if(<compare([currentitemcode], "equal" ,801)>,<umptoscript(" presenttrucyprofilecorrect")>,<umptoscript("presenttrucy 
profilewrong")>); 


[presenttrucyprofilecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableenanormal"); 
runscript("setlipsynctochar"); 
message("H mmm, that is interesting..."); 
jumptoscript("simpleexamine’); 


[presenttrucyprofilewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
message("W hat about this?"); 
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runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 

message("I'm not sure about this, you \nknow...!"); 
jumptoscript("scenel"); 


[simpleexamine] 
runscript("pw_showmessagebox"); 
setbuttonarea("pw_examineareal",157,302,81,23); 
setvar([pw_examinemaxplaces],1); 
runscript("pw_showtouchananswe™); 
messageauto("So, what is wrong in this place?"); 
runscript("hideowmenu"); 
runscript("pw_showspecialexamine"); 
runscript("pw_waitexaminetouch"); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 
runscript("pw_hidetouchananswer"); 
if(<compare{[pw_examinearea]," equal", 1)>,<umptoscript("simpleexaminecorrect")>,<umptoscript("simpleexaminewro 
ng")>) 


[simpleexaminecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
runscript("pw_setnameboxtonoone’); 
message("H ere!"); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 
message("H mm, yeah, it looks \ninteresting...!"); 
jumptoscript("scenel"); 


[simpleexaminewrong] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
runscript("pw_setnameboxtonoone’); 
message("T his is what proves... er..."); 
runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 
message("I'm not sure about this, you \nknow...!"); 
jumptoscript("scenel"); 
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Tutorial 10: 


Adding Sound Effects 


This tutorial, as the next one will be, would fit perfectly on an AHLSL-only book, as we will only use 
AIGE’s features to add sound effects (sfx) to our game. From not on, we won’t provide the complete source for the 
game, but only what changed (for complete codes, see the tutorial files provided with it). 

First you need to put the sound effect you want to play on the sounds folder. One it’s there, you play it 
using this command: 


loadandplaysfx("01_ Phoenix - takethat.wav",0); 


This will play 01_ Phoenix - takethat.wav on sfx channel 0. C hannes are used to play more than one sfx 
at a given time. And sfx will play once. 
In our game, here is where we will edit to add the sfx playback: 


[presenttrucyevidence] 

definevar([signal],"int"); 

runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 
runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 

loadandplaysfx("01_ Phoenix - takethat.wav",0); 
runscript("pw_raisetakethat"); 

wait(6); 
if(<compare([currentitemcode],"equal",902)>,<umptoscript(" presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


And this concludes our tutorial on sfx playback. Simple, huh? 


Tutorial 11: 


Adding M usic 


Adding music is as simple as adding sound effects, so there isn’t a need to prolong this tutorial. AH LSL 
provides two ways for music playback. We can use the normal bgm system (limited to wav and mid) or use the mp3 
system (supporting one mp3 at any given time). W e will use the mp3 system because most of Ace Attorney series music 
are on mp3: 
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loadandplaymp3("music/05 - Examination ~M oderate 2007.mp3",0,"N"); 


Differently from sound effects that must be on the sounds folder, you can place on any folder starting 
from the one where AIG E.exe is (So you can use any music from any subfolder of the folder where AIG E.exe is). W e use 
normally music for easy organization. The first parameter is the path to the music. The second parameter is always 0 
(when mp3 system get support to more than one mp3 at once, it will be used to define the channad). T he last parameter 
is if you want to play once (“O”) or constantly repeat (anything else from “O”). To stop playback, use: 


stopmp3\(); 


And this concludes our tutorial. So in our tutorial we will change: 


[enterscenel] 

runscript("pw_useowbgcourthall"); 

runscript("pw_showadvarrowmenu"); 

loadandplaymp3("music/02 Courtroom Lounge ~N everending O verture.mp3",0,"N"); 
jumptoscript("scenel"); 


So we get playback before scenel begins. 
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Tutorial 12: 


M aking Questions 


Questions aren’t used much into Phoenix W right games, but are a good feature to have. But as we will 
see, it isn’t a hard feature to put in your game: 


[questionexample] 

definevar([qreplysignal],"int"); 

messageauto("But, what was T rucy's \nlast name again?"); 
runscript("pw_showselectananswer"); 
setvar([pw_maxquestions],4); 

setvar([pw_q1gfx],91000); 

setvar([pw_q2gfx],91010); 

setvar([pw_q3gfx],91020); 

setvar([pw_q4gfx],91030); 

runscript("hideowmenu"); 
runscript("pw_setupquestions’); 
runscript("pw_showquestion"); 

waitsignal("qreply" [qreplysignal]); 
runscript("pw_hideselectananswer"); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 
if(<compare([qreplysignal]," equal" ,3)>,<umptoscript(" questionexamplecorrect") >,<umptoscript("questionexamplewron 
g")>); 


W e use the same structure as on present and examine. As with examine, we need to configure the feature. 
In questions, we define the number of questions and the button’s graphic. T his time we will use a bit more of the power 
of the waitsignal too. 

First of all, we define a variable we will use for the waitsignal, with the name of qreplysignal of type 
integer (int for AIGE). Than as usual we define the message, and show the “Select an Answer”: 


runscript("pw_showselectananswer"); 


It islike the T ouch an Answer call we did for examine. Then comes the important part: 


setvar([pw_maxquestions],4); 
setvar([pw_q1gfx],91000); 
setvar([pw_q2gfx],91010); 
setvar([pw_q3gfx],91020); 
setvar([pw_q4gfx],91030) 
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W edefine the number of replies we want to use. From 1 to 4. Then we define on each question reply slot 
the graphic of the button. If we use 2, we only set for q1 and q2 ones. It works like defining areas for examine. 
Then we do the question setup and show it: 


runscript("hideowmenu"); 
runscript("pw_setupquestions’); 
runscript("pw_showquestion"); 
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H ide the current lower screen window, setup the questions (this is required for PW Lib to configure the 
questions properly) and show the questions afterwards. 
N ow we do the final configures: 


waitsignal("qreply" [qreplysignal]); 
runscript("pw_hideselectananswer"); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 


W e wait for the user to click an reply. This time on the waitsignal we use the variable that we defined for 
a really important result: we will store on that variable the code of the reply the user clicked. Then after the while, we 
revert back to the previous state of the screen (hide select an answer, and resume to the Advance Arrow lower screen.). 
With that we come to the if to get the question’s answer: 


if(<compare([qreplysignal], "equal" ,3)>,<umptoscript(" questionexamplecorrect")>,<umptoscript(" questionexamplewron 
g")>); 


W e use that variable we defined for comparison. T he codes we can compare is: 1, 2, 3 and 4, and will be 
the one the user clicked. As with present, you can use various ifs to get various replies and go to various different blocks: 


><null()>); 


if(<compare{[qreplysignal ]," equal", 1)>,<umptoscript("qlr1" ) 
>,<null()>); 
) 
) 


) 
if(<compare([qreplysignal],"equal",2)>,<qumptoscript("q1r2" 

) >,<null()>); 

) ><null()>); 


if(<compare([qreplysignal]," equal" ,3)>,<umptoscript("q1r3" 
if(<compare([qreplysignal]," equal" ,4)>,<umptoscript("q1r4" 


wo ee eS ia 


So it can be easily expanded. The correct and wrong functions for the questions are simple: 


[questionexamplewrong] 
message("T hat doesn't seem right..."); 
jumptoscript("scenel"); 


[questionexamplecorrect] 
message("Y ou're correct!"); 
jumptoscript("scenel"); 


Nothing special. They are simple, as we don’t need much control here. You can do as usual and add 
showmessagebox stuff, make the talking longer, etc. H ere is what changed on the script we made: 


[simpleexaminecorrect] 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtophoenix"); 
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runscript("setlipsynctonoone"); 

message("H ere!"); 

runscript("setlipsynctochar"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
runscript("setlipsynctochar"); 

message("H mm, yeah, it looks \ninteresting...!"); 
jumptoscript("questionexample"); 


[questionexample] 

definevar([qreplysignal],"int"); 

messageauto("But, what was T rucy's \nlast name again?"); 
runscript("pw_showselectananswer"); 
setvar([pw_maxquestions],4); 

setvar([pw_q1gfx],91000); 

setvar([pw_q2gfx],91010); 

setvar([pw_q3gfx],91020); 

setvar([pw_q4gfx],91030); 

runscript("hideowmenu"); 
runscript("pw_setupquestions’); 
runscript("pw_showquestion"); 
waitsignal("qreply" [ qreplysignal]); 
runscript("pw_hideselectananswer"); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 
if(<compare([qreplysignal]," equal" ,3)>,<umptoscript("questionexamplecorrect") >, <umptoscript("questionexamplewron 
g")>); 


[questionexamplewrong] 
message{"T hat doesn't seem right..."); 
jumptoscript("scenel"); 


[questionexamplecorrect] 
message("Y ou're correct! "); 
jumptoscript("scenel"); 


And we are done with questions. They aren’t hard to use as well, so this mostly concludes the basic 
features we can use on PWLib. Things like Psyche Locks aren’t usable in PWLib Hayase because there are no chains, 
locks animations and examine/present misses the Stop command (witch may be added easily on a next revision according 
to KSA T echnology). 

Now let’s add some effects! Another AHLSL-only lesson, but that will give life to your games. 


Tutorial 13: 


Adding Basic Effects 


Effects are the life force of some scenes. They really liven up a game, and give a different feel about the 
events it contains. Phoenix W right games are like that. Effects help giving a strong new horde of feelings to what the 
characters do on screen. Let’s give a more dramatic feel to your scenes, make the players get deeper into your creations. 

The basic effects that we have on AIGE are: slide, shake, fade, fade screen, flash and blink. We will begin 
with the prototypes (format of the parameters) for each one of the effect commands: 
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placeslide(“object_name”, ”object_type”, max_duration, speed_x, speed_y, attenuation_x, attenuation_y, limit_x, 
limit_y); 


placeshake(“object_name”, “object_type”, max_duration, strength, attenuation); 
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placefade(“object_name”, “object_type”, max_duration, “fade_style”); 


fadescreen(max_duration, “fade_style”); 


placefadescreenex(max_duration, “fade_style”, color_red, color_green, color_blue, color_alpha); 


placeblink(“object_name”, “object_type”, Max_duration, blink_interval, blink_attenuation); 


placeflash(max_duration); 


Now let’s explain each of the parameters. The “object_name” and “object_type” parameters define an 
object (since we can have two objects with the same name of different types). We will provide a list of 
object_name/object_type for basic PW Lib objects once we complete the explanation on the parameters. N ext we have 
the max_duration that defines the max time for that effect to last. W e have it in a frames value (so to know the time in 
seconds, we use max_duration/60). The speed_x and speed_y defines the speed on x and y respectively for the slide to 
go. Positive and negative values are possible, so if you want to go backwards or upwards you can use negative speeds. 
These speeds are defined in pixels per iteration (we have 60 iterations per second). The attenuation parameters 
(attenuation_x, attenuation_y, attenuation, blink_attenuation) serve to change the intervals of execution so they get 
smaller and larger according to how much of the duration passed. T hey are good to make swift slowdowns, speedups and 
such. Now strength defines how much “power” the shake will have. The attenuation can make it stronger or weaker. 
Now “fade_style” defines if it is a fade-in or fade-out. With “I” it is a fade-in, and “O” it is a fade-out. The color 
parameters (color_red, color_green, color_blue, color_alpha) allow you to define the color of the fade T hey are from 0 
to 255 (normal RGBA component color limit). 255 on red mean full red color, for example. The “blink_interval” 
defines the interval between the object blinks. 

Parameters explained, we can go and see the list of object/types: 
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object_name object_type Description 
- bg The Background. 
- msgbox The M essage Box. 
pw_char char The Character. 
pwnamebox genobj The N ame Box. 
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The list may get bigger as PWLib advances, but for now we don’t have more objects to play with. All new 


ones you will create, but this will be explained in another tutorial. T his concludes our tutorial. 


Tutorial 14: 


Adding Advanced Effects 
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N ow wewill explain the two remaining effects that you will be able to usein your game. T hey are: wipe 
and flip. W e will use the same format as the previous tutorial: 


placeflip(“object_name”, “object_type”, flip_step, flip_delay, flip_org_angle, flip_dest_angle); 


placewipe(“object_name”, “object_type”, wipe_speed, wipe_delay, “direction”); 


Some of the names are well known, so let’s see the new ones. The “flip_step” means how much of angle 
you want to add per iteration. W e are using 90 degrees here, so it must not be large if you want a swift flip. W e will 
provide an example of how to use positive or negative values. The “flip_org_angle” and “flip_dest_angle” also need 
example for usage, but the they define the origin and destination angles for flip. “The “flip_delay” defines a delay 
between the flip steps. As always, frames, so in seconds: frames/60. 

As those effects are a bit harder, we will separate effect per effect. H ere are the most common usage for 
flip in and flip out: 


placeflip("pw_crevibase","genobj",-15,1,90,0); 


placeflip("pw_crevibase","genobj",15,1,0,90); 


Both are respectively in and out. T hose are code from the PW Lib source, if you want to ask. W enormally 
use 90 as base angle value, too. 

Well, not to the wipe effect, the parameters: “wipe_speed” defines the speed for the wipe. Positive is show 
and negative is hiding. The “wipe_delay” works like on flip_delay: a small delay per iteration. But “direction” defines if 
the wipe is up or down. For now AIGE doesn’t support left and right wipes, but according to KSA Technology, AIGE 
will in a near future. “U” defines up and “D” defines down. N ot much mystery in those. And again another fast tutorial 
completed. There isn’t much to say about effects, as their definition itself mostly is it. 
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Tutorial 15: 
Advanced M essage Features 


Now let’s go back to nice tutorials. You might have noticed in Ace Attorney games were the message 
suddenly stops for a second, than resumes without clicking? Or messages colored with a different tone? You can use 
AIGE’s message commands to create interesting messages with nice results. This tutorial allows you to develop 
conversations like Old Bag’s constant blabbering, for example. Let’s go a bit deeper into what AIGE provide us for 
messages. 

M essages in AIGE are executed by enabling the message box and using one of the message commands. So 
fat you have seen the message and messageauto ones. But we have more. Ever wanted to put commands between your 
message texts? T he solution is using one of the append message commands: messageappend and messageappendauto. 
The messageappend is for the message what messageappendauto is for messageauto. If you want to separate the text into 
more than two slices, you use messageappendauto. Let’s give it an example: 


messageauto(“Oh...”); 

wait(4); 

messageappendauto(“ H-Hello...”); 
wait(6); 


messageappend(“ I-I...”); 


The no-auto message commands trigger the advance arrow (or the current lower screen advancing 
method), so you will have the player to click to advance. Remember to size your message and use proper newline controls 
(the \n). In the example, your final message will be: “Oh... H-Hello... I-I...”, but as it draws you will notice the pauses. 
You can put anything between the message commands, but be sure to think before doing it. Effects are okay, and that’s 
mostly the use for appending. You can do what you want, but be careful. 

There are more message commands, so let’s list all message commands here for reference: 


message 
messateinstant 
messageinstantauto 
messaged rop 

messageauto 
messageappend 
messageappendauto 
messageappendinstant 
messageappendinstantauto 


N ee 


The “instant” modifier puts the whole text without the usual letter by letter. The drop is like normal 
message. And with this we conclude our tutorial on messages. | ust remember to use your imagination to create the best 
effects. 
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Tutorial 16: 
T he Evidence Box 


Sometimes in the games you see a small box popping out with the evidence graphics in it. PWLib 
supports such feature, and it is really simple to use in your games. PW Lib automatically creates it for you, all you need to 
do is define the evidence or profile to use and show it. First, let’s learn how to tell PWLib the evidence or profile to 
show: 
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setvar([pw_evidtoshowinbox],2001); 


In this case, 2001 is the id of a profile. Once you set the variable pw_evidtoshowinbox to that, you can 
show the evidence box, but you need to determinate the side left or right. T his line shows in the left side 


runscript("pw_showflyingevidboxleft"); 


And this one on the right side: 


runscript("pw_showflyingevidboxright"); 


N ow that is shown, you may want to hide it. Each side has its own hide function. 


runscript("pw_hideflyingevidboxleft"); 


And: 


runscript("pw_hideflyingevidboxright"); 


Remember to use both in synchronization. N ot that the system will lock, but you get a not so nice visual 
effect as a result. T ake care to make your games as better as possible. After all, effects are to make the game better. 
W ejus came to the conclusion of one more basic tutorial. N ext, we see Introduction M ovies! 
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(this tutorial will be done later) 


Tutorial 17: 


M aking Introduction M ovies 


ourt Room Tutorials 


“Beneath lies is where the truth sleeps.” 


The Court Room is where most of the magic of an Ace Attorney game lies. Designing intriguing cases, 
objecting to unexpected evidence, everything to pursue the truth. Focusing on this area of the games, we will learn how 
to deploy a top quality Court session with PW Lib. Ready? 
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Tutorial 01: 


M oving Around the Court 
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With the basics just learned, we can begin working on the Court itself. But first we must know how the 
Court itself works in PW Lib. By default, you have 5 main locations in the Court: Judge's Bench, Attorney’s Bench, 
Prosecutor's Bench, W itness' Bench and H elper View. PW Lib provides 5 functions that sets such places correctly (so you 
go to it directly with only one call). Those functions are the main way to move around the Court. H ere is the list of 
places -> functions that PW Lib expose 


Judge's Bench ->runscript("pw_showjudgetable"); 
Attorney's Bench ->runscript("pw_showattorneystand"); 
Prosecutor's Bench ->runscript("pw_showprosecutorstand"); 
Witness’ Bench ->runscript("pw_showwitnessstand"); 

H elper View ->runscript("pw_showcocouncilstand"); 


But as you go to one of those places, you need to set a character (as usual). But those commands do the 
usual "instant go". There is a lot more you can do, such as the fast camera move from Attorney's Bench to Prosecutor's 
Bench. As a method of protection, you will only be able to do the camera move if you are on the correct place (eg. you 
won't be able to slide from Attorney’s Bench to Witness’ Bench if you are on the J udge's Bench). 

We have one function for each possible camera move. Here is a table of the origin/destination -> 
functions: 


Attorney's Bench/Prosecutor's Bench ->runscript("pw_slideattoneytoprosecutor"); 
Attorney's Bench/W itness Bench ->runscript("pw_slideattoneytowitness’); 
Prosecutor's Bench/Attorney's Bench ->runscript("pw_slideprosecutortoattoney"); 
Prosecutor's Bench/Witness' Bench ->runscript("pw_slideprosecutortowitness'); 
Witness’ Bench/Attorney'sBench ->runscript("pw_slidewitnesstoattorney"); 
Witness’ Bench/Prosecutor's Bench ->runscript("pw_slidewitnesstoprosecutor"); 


But there is still one configuration needed to make the camera move work perfectly: you need to set the 
"target" character to be shown. for that you use a special variable With setvar you set to the function's name of the 
character/pose you need. H ere isan example: 


setvar([sld_targetcharanim],"pw_enableemasurprised"); 


The "other side" character will be Ema in her surprised animation. H ere is a simple example of a Court 
code: 


runscript("pw_showattorneystand"); 
runscript("pw_enableemaunsure’); 

message("what?"); 
setvar([sld_targetcharanim],"pw_enableemanormal"); 
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runscript("pw_slideattoneytowitness"); 

messagg "done" ); 
setvar([sld_targetcharanim],"pw_enableemamad"); 
runscript("pw_slidewitnesstoprosecutor"); 
message("done2!"); 
runscript("pw_showattorneystand"); 
setvar([sld_targetcharanim],"pw_enableemaunsure"); 
runscript("pw_slideattoneytoprosecutor"); 
message("done3!"); 
setvar([sld_targetcharanim],"pw_enableemasurprised"); 
runscript("pw_slideprosecutortoattoney"); 
message{"done4!"); 


The messages are what they will say, not much story in this, but a good example to see stuff working. 
This isn't a code meant to make a scene that "fits", it is just an example to see the results. You can create a test game 
using this code to see the results. D on't forget to initialize Young Ema for it. 


Tutorial 02: 
U sing the Court Room O verview 


The Court Room Overview (referred as CRO in PWLib sometimes) is one of the most interesting 
features in Court. It has 4 main objects that you use: the judge, the prosecutor, the attorney and the witness. You set 
their graphic with the characters graphics you want to. H ereis the code setting all four graphics: 
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setgenobjgraphic("pw_crowitness",-7000); 
setgenobjgraphic("pw_crojudge",- 7001); 
setgenobjgraphic("pw_croprosecutor",-7002); 
setgenobjgraphic("pw_croattorney",- 7003); 


Their names are self explanatory. But there are special, defined sizes for each one of the four objects. H ere 
is the table of the sizes: 


Attorney: 50x 80 
Prosecutor: 50 x 70 
Judge 30x 30 
Witness: 100 x 100 


N ow once you finish configuring the objects of the CRO, you need to show it: 


runscript("pw_showcourtroomoverview"); 


And you're set. You can show and hide the M essage Box and use the message commands as usual. To 
hideit, we use: 


runscript("pw_hidecourtroomoverview"); 


And you can use the Court Room O verview. 
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Tutorial 03: 


H itting the G avel! 


Hitting the gavel is one of the simple easy to use functions you will use a lot in your cases. Every judge 
uses it. O rder! 

PW Lib has auto-included the 1 hit and 3 hit gavel animations. You can use the message box during a 
gavel hit, but you might want to hide it. H ere is the 1 hit: 


runscript("pw_showgavelhit"); 


And three hits: 


runscript("pw_showgaveltriplehit"); 


Once you used one, you need to reset place/background image, as expected. T he gavel hit effect itself is 
one auto-controlled function, so it does its own wait. You won’t need to put wait and calculate it precisely. And this 
concludes out tutorial with the G aval. 


Tutorial 04: 
T estimony: Cross Examination 
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Cross Examination is one of Phoenix Wright games most interactive areas. PW Lib provide support for 
them, but it is taken as the hardest feature to use. In order to make it easier to develop, we will divide the tutorial into 
two main areas: the W itness T estimony and the Cross Examination itself. T he first one is simple, but define how many 
stages the C ross Examination will have (not considering the amends, that will be defined in next tutorial). 

First of all, draw what your Cross Examination will have. It is the first step into making Cross 
Examinations easier to use. In my case, I’ll exemplify the creation process by creating my own Testimony. You will have 
yours to work with, so follow with attention. H ere is a simple sequence of T estimony that will be used in this tutorial. 
Ema will be our character who will testify to the court. 

Testimony: The Knife 
i Ema: | bought the knife from a local seller. 
i Ema: It cost me about U $D : 4,59. 
| Ema: But the handle broke when | used it the first time. 
| Ema: | didn't threw it away because its cutting was very good. 

A simple testimony about a knife, the murder weapon on this tutorial's case. Once you have the 
statements done, you can do the Witness T estimony part. T he Witness T estimony and T estimony animations are shown 
using those functions respectively: 


runscript("pw_showwitnesstestimony"); 
runscript("pw_showtestimony"); 


N ow with them you build the Witness T estimony, this way for example: 


[witnesstestimonytest1] 
runscript("showpwchar"); 
runscript("pw_showwitnessstand"); 
setmsgboxtextcolor(255,0,255,0); 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtonoone’); 
runscript("pw_enableemadown"); 
messageinstantauto("\n — --The Knife-"); 
setmsgboxtextcolor(255,255,255,255); 
runscript("pw_showwitnesstestimony"); 
runscript("pw_showtestimony"); 
runscript("pw_setnameboxtoema"); 
runscript("pw_enableemanormal"); 
message("!| bought the knife from a local seller."); 
message("It cost me about U $D : 4,59."); 
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runscript("pw_enableenadown"); 

message("But the handle broke when | used it the first time."); 
runscript("pw_enableemanormal"); 

message{"! didn't threw it away because its cutting was very good."); 
wait(10); 

jumptoscript("talks2"); 
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There we sæ new AIGE commands, too. The setmsgboxcolor sets the color of the whole text on the 
message box. W e set it to green (255,0,255,0) since the format the command uses is A,R,G,B. The second call resumes 
the color to white. T his is out Witness T estimony part. N ot much of an issue with this, as it's like a normal talk. 

For organization, you separate the talk that follows (when the testimony ends and the cross examination 
begins). It will be the talks2 function. For this tutorial we won't make this talk (as it would be only a simple talk, 
nothing special). From talks2 we will jump to the function crossstart, that will setup the cross examination for us. 


[crossstart] 
setvar([pw_crossexamattorneycode],36); 
setvar([pw_crossexamprosecutorcode],35); 
runscript("hideowmenu"); 
runscript("pw_showmessagebox"); 
runscript("pw_setnameboxtonoone’); 
messageinstantauto("\n = --The Knife--"); 
runscript("pw_showcrossexaminationvs'); 
runscript("pw_showpwmenubasicrec"); 
waitresponse(); 
jumptoscript("crossbegin"); 


This function defines the Cross Examination VS screen graphics and show it. T he format of this function 
will be the same, only changing the message value and the prosecutor/attorney codes. PW Lib comes with the original 
graphics as listed below: 

i Edgeworth: 30 
i Franziska: 31 
: Manfred: 33 
| Phoenix: 36 

i Payne: 35 

i Mia 34 

i Godot: 32 


The new functions are: 


runscript("pw_showcrossexaminationvs'); 


It shows the VS effect (Prosecutor vs. Attorney). N ext we have: 


runscript("pw_showpwmenubasicrec"); 


That is the “Special Show” for the Advance Arrow window. Differently from the normal show, it forces 
showing the arrow. Internally, the Advance Arrow window is also called Basic M enu. The waitresponse is optional, but 
forces the player to click to advance as the effect is completed. 
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That concludes the first part: Witness Testimony. You can do on Witness T estimony just like a normal 
talk. You can change the background setting it to other image, hide the character and the bench. To hide the character, 
you use: 


runscript(“hidepwchar”); 


And to hide the bench (in case you want to use a photo as the background) you must use: 
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runscript(“pw_hidecourtbench”); 


It will hide the bench, and to show it again you must “go to the witness stand” again, using the command 
explained earlier. But remember that the next statement needs to show the character again. N ow we will go directly to 
the cross examination (using the crossbegin jump), but you can make conversation and court scenes before going to the 
cross examination. W e will opt for this way of explanation to make the tutorial focused on Cross Examination. 


Now let’s continue to the second part of this tutorial: Cross Examination. It is the hard part of this 
tutorial, so take your time to understand it. First we will sit and explain the “crossbegin” code. It controls the start of the 
cross examination. It will configure the cross examination’s basics. Here is the code for the crossbegin function: 


[crossbegin] 
runscript("hideowmenu"); 
runscript("begincrossexamination"); 
setvar([fpwcrossexam stages] ,4); 
jumptoscript("crossl"); 


Here we’re hiding the advance arrow menu and showing the Cross Examination interface: 
runscript("begincrossexamination"); 


And then we set the initial size of the Cross Examination by setting the pwcrossexamstages. T hat 
represents the number of statements. In our example we have 4 statements. W e can have examinations with amending 
testimony, but this will be explained on the next tutorial. 

N ow that the crossbegin is done, we start working on the Cross Examination itself. For each statement, 
we create a function. Example: 


[crossl-1] 
[crossl-2] 
[crossl-3] 


[crossl-4] 


In our example, we will need 4 functions since we have 4 statements. N ow each one of the functions will 
have the same format, like this: 


[crossK ] 
definevar([signal],"int"); 
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setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemaunsure’); 
runscript("pw_setnameboxtoema"); 
message("I testified!”); 
waitsignal("advance" [signal]); 
if(<compare([signal],"equal",1 
if(<compare([signal],"equal",2 
if(<compare([signal],"equal",3 
if(<compare([signal],"equal",4 


>,<jumptoscript("crosskpresent")>,<null()>); //present 
>,<umptoscript("crosskpress")>,<null()>); //press 
>,<sumptoscript("crossk-1")>,<null()>); //prev 
>,<umptoscript("crossk+1")>,<null()>); //next 
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This example is simple, and illustrates the base format required. W e set the character to the needed pose 
and then it waits for a signal. This time the signal is important: it defines what the player did on the screen. Value 1 
means he presented something. Value 2 means he clicked Press. Value 3 means he clocked the Back arrow and value 4 
that he clicked the Next arrow. The first cross examination statement doesn’t have a back arrow, so you don’t need to 
put the if for that. So you create 2 more functions to handle press and present. 

But you still need to know some things to make better use of the feature. In the Present function 
(crosskpress in the example), you must check for the item to define the appropriated reply (you use the same way you did 
with presenting evidence/profiles). The Press function (crosskpress in the example) you can go directly to talk, no testing 
required. In both Back and N ext, you set to the next and previous statements, eg: in out testimony, in crossl-2 the next 
would be crossl-3 and previous crossl-1. Also on the last statement, you must go to the “crossend”, that is a function 
that will resume back to the top of the Cross Examination after a bit of talk (like in PW games where M aya comments 
stuff when you advance on the last statement). 

To clarify things, here is how the cross examination structure of our tutorial example would look like in 
the end: 


[crossbegin] 
runscript("hideowmenu"); 
runscript("begincrossexamination"); 
setvar([pwcrossexamstages] ,4); 
jumptoscript("crossl-1"); 


[crossl-1] 

definevar([signal],"int"); 

setmsgboxtextcolor(255,0,255,0); 

runscript("pw_enableemanormal"); 

runscript("pw_setnameboxtoema"); 

message("| bought the knife from a local seller"); 

waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1)>,<jumptoscript("crossl-1present")>,<null()>); //present 
if(<compare([signal]," equal" ,2)>,<umptoscript("cross1-1press')>,<null()>); //press 
if(<compare([signal]," equal" ,4)>,<umptoscript("crossl-2")>,<null()>); //next 


[crossl-1press] 
runscript("nextpwcrossexamsi mple"); 
jumptoscript("crossl-2"); 


[crossl-1present] 
jumptoscript("crossl-1"); 


[crossl-2] 
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definevar([signal],"int"); 
setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 
message("It cost me about U $D : 4,59."); 
waitsignal("advance'" [signal ]); 
if(<compare([signal],"equal",1 
if(<compare([signal],"equal",2 
if(<compare([signal],"equal",3 
if(<compare([signal],"equal",4 


>,<jumptoscript("crossl-2present")>,<null()>); //present 
>,<umptoscript("crossl-2press")>,<null()>); //press 
>,<jumptoscript("crossl-1")>,<null()>); //prev 
>,<jumptoscript("cross1-3")>,<null()>); //next 


[crossl-2press] 
runscript("nextpwcrossexamsimple"); 
jumptoscript("cross1-3"); 


[crossl-2present] 
jumptoscript("crossl-2"); 


[crossl-3] 
definevar([signal],"int"); 
setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemadown"); 
runscript("pw_setnameboxtoema"); 

message{"But the handle broke when | used it the first time."); 
waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1 
if(<compare([signal],"equal",2 
if(<compare([signal],"equal",3 
if(<compare([signal],"equal",4 


>,<jumptoscript("crossl-3present")>,<null()>); //present 
>,<umptoscript("crossl-3press")>,<null()>); //press 
>,<jumptoscript("crossl-2")>,<null()>); //prev 
>,<umptoscript("cross1-4")>,<null()>); //next 
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[crossl-3press] 
runscript("nextpwcrossexamsi mple"); 
jumptoscript("crossl-4"); 


[crossl-3present] 
jumptoscript("cross1-3"); 


[crossl-4] 
definevar([signal],"int"); 
setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("! didn't threw it away because its cutting was very good."); 
waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1 
if(<compare([signal],"equal",2 
if(<compare([signal],"equal",3 
if(<compare([signal],"equal",4 


>,<jumptoscript("crossl-4present")>,<null()>); //present 
>,<umptoscript("crossl-4press")>,<null()>); //press 
>,<jumptoscript("crossl-3")>,<null()>); //prev 
>,<jumptoscript("crossend")>,<null()>); //next 


Pee ek ee ee 


[crossl-4press] 
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runscript("nextpwcrossexamsimple"); 
jumptoscript("crossend"); 


[crossl-4present] 
jumptoscript("crossl-4"); 


[crossend] 
runscript("resumepwcrossexamsimple"); 
jumptoscript("crossl-1"); 


Asalast none, there are two functions we need to explain. They are the 


runscript("resumepwcrossexamsimple"); 


runscript("nextpwcrossexamsimple"); 


The first one is to be used on crossend when returning to the first statement of the Cross Examination. It 
resets the statement count and so let PW Lib know that we are on the first statement. 

The second oneis to be used if we are going to the next statement from a press or present function. T his 
tells PW Lib we are going to the next statement. 


And this concludes our tutorial on Cross Examinations. N ext we will explain a bit deeper about Cross 
Examination Control, and then how to make Amended T estimony work with the C ross Examination. 


Tutorial 05: 
Advanced Cross Examination Control 


Before we start working with Amending Testimony, we will explain how to control flow on Cross 
Examinations. We can use this technique on other areas of PW Lib development as well. First we will be defining and 
using variables. D uring past tutorials, we seen the setvar command. You used AIGE's global variables only, but now we 
are going to define our own variables. 

Asa matter or easiness, we will begin working with global variables only. T hey can be accessed anywhere 
after it was defined. T o define a new variable, we use: 
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definevarglobal([varname],"type"): 


The varname is the name of the variable we are going to use. As type we have several, but we will only use 
the int (integer) one. Good naming helps making the code better organized and easier to understand and maintain. We 
won't explain the setvar since we already did. W e will jump to the next command: 


modifyvar([varname], "modification", value); 


This allows you to modify the value of a variable instead of setting it directly. The modifications you can 
do with your variable are: add, subtract, multiply, divide. T hey are the basic arithmetic commands you can do. 

With this base set explained, we can start using them. We will develop a simple cross examination with 
conditional press (you press on A so at B when pressing you get a different result). T his T estimony will be 


——=-= = === = SSS ee ag ee 1 
' 


i 1: | didn`t see anything that night. 
2: | only heard aloud thud. 
i 3: It was about 2:00AM . 


' 
Det NN N ee eee ee en ee l 


Let's say that pressing on 2 gives: "H ow loud it was?" and the witness replies: "Something that couldn't 
wake up someone", and pressing on statement 3 gives: "2:00 AM ? Are you sure?" and the witness replies "Yes, | just 
woke up and seen the clock on my bed table". You can see that Press 2 contradicts Press 3. But you can only 
make Phoenix comment statement 3°s press if you did Press statement 2. H ow do we use variables to get such effect? 

First, let's define the Cross Examination Skeleton. Before adding special control, make the Cross 
Examination’ s base: 


[cross01start] 
definevarglobal([0203contra],"int"); 
setvar([0203contra],0); 

[cross01-1] 


[cross01-1press] 


og PR 
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[cross01-1present] 
[cross01-2] 


[cross01-2press] 
setvar([0203contra],1); 


[cross01-2present] 
[cross01-3] 


[cross01-3press] 
if(<compare{[0203contral]," equal" ,0)>,<umptoscript("cross01-3pressorg")>,<umptoscript("cross0103presscontrad")>); 


[cross01-3pressorg] 
[cross0103presscontrad] 
[cross01-3present] 


[crossOlend] 


This skeleton shows only how to use variables to change the flow using the if AH LSL command. First, we 
start the cross examination (as it will only run once) and set the control variable (that will be used to control the flow). 
W e name it 0203contra and set type to int. Asa first value, we set to 0. 

W hen the player presses statement 2, we set the variable to 1 (since we want to “if pressed statement 2, we 
change statement 3 press"). So, on statement 3 we use the if command to check the value of the variable we created. If 
it's 0, we follow the original testimony press (since we didn’t see the press on statement 2, so we have no logic to 
contradict). If its 1 (that is set when we Press on statement 2) we go to the "contraction" version of the Press. 

This simple example shows that you can make the messages shown on each statement to change using 
"control variables". You can have multiple ifs per press/present too, according to what you want to do. First, draw how 
your Cross Examination will be. Planning is essential to develop a good Cross Examination. It helps a lot defining how 
many variables to use, how to use them. 

And this finishes the tutorial about Advanced Cross Examinations. We will now explain how to Amend 
Testimony on Cross Examinations. 


Tutorial 06: 
Amending T estimony on Cross Examination 
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This tutorial is supplenentary to tutorial 4 and 5, and needs knowledge of ALL Cross Examination 
workings before you proceed. M ake sure you know the theory proposed on tutorials 4 and 5 before trying this one 
Tutorial 05 is the most important one, since we will be using variables to develop the amend process. 


First, we define how the testimony will be J ust to take a different one, we will show anew written one: 


i Evidence: Photo 04 
+ Description: Shows a silhouette of a woman. T aken on the crime scene by the security camera at the time of the murder. 


1: | was returning from the packing area when | saw it. 
2.0: The shadow made me stop, since! didn't expected it there. 
2.1: The shadow was of aman holding a large pipe 
3: | heard aloud thud and left running. 


Testimony: T he Shadow 
I 
i 


In this testimony, the 1 and 3 are normal testimony lines (can't have testimony added on them), while 
2.0 can and 2.1 is the amended text. T his format will be used in this tutorial for reference. First, let's build the skeleton 
of the Cross Examination: 


[crossT begin] 
[crossT -1] 

[crossT -1press] 
[crossT -1present] 
[crossT -2.0] 
[crossT -2.0press] 
[crossT -2.0present] 
[crossT -2.1] 
[crossT -2.1 press] 


[crossT -2.1present] 
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[crossT -3] 
[crossT -3press] 
[crossT -3present] 


[crossT end] 


As usual we define each statement. But since one is hidden at first, something changes from normal 
creation: 


[crossT begin] 
runscript("hideowmenu"); 
runscript("begincrossexamination"); 
setvar([fpwcrossexamstages],3); 
jumptoscript("crossT -1"); 


W e begin with only 3 statements max. W e only have three as we begin, and the 4th won't be seen 
unless you PRESS on statement 2.0. Let's make the base code for this C ross Examination, but 2.1 won't be accessible: 


[crossT begin] 
runscript("hideowmenu"); 
runscript("begincrossexamination"); 
setvar([fpwcrossexamstages],3); 
jumptoscript("crossT -1"); 


//First Statement 

[crossT -1] 

definevar([signal],"int"); 

setmsgboxtextcolor(255,0,255,0); 

runscript("pw_enableemanormal"); 

runscript("pw_setnameboxtoema"); 

message("| was returning from the \npacking area when I saw it."); 
waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1)>,<umptoscript("crossT -Lpresent")>,<null()>); //present 
if(<compare{[signal],"equal",2)>,<jumptoscript("crossT -1press")>,<null()>); //press 
if(<compare([signal]," equal" ,4)>,<umptoscript("crossT -2.0")>,<null()>); //next 


[crossT -1press] 
runscript("nextpwcrossexamsimple"); 
jumptoscript("crossT -2.0"); 


[crossT -1present] 
jumptoscript("crossT -1"); 


//Second Statement 

[crossT -2.0] 
definevar([signal],"int"); 
setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemanormal"); 
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runscript("pw_setnameboxtoema"); 

message("T he shadow made me stop, \nsince! didn't expected it \nthere."); 
waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1 
if(<compare([signal],"equal",2 
if(<compare([signal]," equal" 3 
if(<compare([signal],"equal",4 


>,<umptoscript("crossT -2.0present")>,<null()>); //present 
>,<jumptoscript("crossT -2.0press")>,<null()>); //press 
>,<umptoscript("crossT -1")>,<null()>); //prev 
>,<jumptoscript("crossT -3")>,<null()>); //next 


ee ee ee 


[crossT -2.0press] 
runscript("nextpwcrossexamsimple"); 
jumptoscript("crossT -3"); 


[crossT -2.0present] 
jumptoscript("crossT -2.0"); 


//Second (Amended) Statement 

[cross -2.1] 

definevar([signal],"int"); 

setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("T he shadow was of aman \nholding a large pipe."); 
waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1 
if(<compare([signal],"equal",2 
if(<compare([signal],"equal",3 
if(<compare([signal],"equal",4 


>,<umptoscript("crossT -2.1present")>,<null()>); //present 
>,sumptoscript("crossT -2.1press")>,<null()>); //press 
>,<jumptoscript("crossT -2.0")>,<null()>); //prev 
>,<jumptoscript("crossT -3")>,<null()>); //next 


aE alee ey 


[crossT -2.1 press] 
runscript("nextpwcrossexamsimple"); 
jumptoscript("crossT -3"); 


[crossT -2.1present] 
jumptoscript("crossT -2.1"); 


//Third Statement 
[crossT -3] 
definevar([signal],"int"); 
setmsgboxtextcolor(255,0,255,0); 
runscript("pw_enableemanormal"); 
runscript("pw_setnameboxtoema"); 

message("| heard aloud thud and \nleft running."); 
waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1 
if(<compare{[signal],"equal",2 
if(<compare([signal]," equal" ,3 
if(<compare([signal],"equal",4 


>,<jumptoscript("crossT -3present")>,<null()>); //present 
>,<umptoscript("crossT -3press')>,<null()>); //press 
>,<umptoscript("crossT -2.0")>,<null()>); //prev 
>,<jumptoscript("crossT end")>,<null()>); //next 


PLE eae ee ae 


[crossT -3press] 
runscript("nextpwcrossexamsimple"); 


ef ee, fe 
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jumptoscript("crossT end"); 


[crossT -3present] 
jumptoscript("crossT -3"); 


//End (Extra) Function 

[crossT end] 
runscript("resumepwcrossexamsimple"); 
jumptoscript("crossT -1"); 


If you noticed, 2.1 acts asa "Mid 2.0 and 3" statement. If you use this code, you will see that the Cross 
Examination will have 3 statements. N ow we want that on the press of statement 2.0, we make the witness amend the 
new part of the testimony (2.1). 

First, we need a new variable. Create an int one at the crossbegin function with the name [crossT amend1] 
and set it to 0: 


[crossT begin] 

definevarglobal([crossT amend1],"int"); 
setvar([crossT amend1],0); 
runscript("hideowmenu"); 
runscript("begincrossexamination"); 
setvar([fpwcrossexamstages],3); 
jumptoscript("crossT -1"); 


N ow create a new function: crossT -2.0bridgeN . Put it just above the crossT -2.1 function: 


[crossT -2.0bridgeN ] 


N ow create a similar one with name crossT -3bridgeB, placing it above crossT end function: 


[crossT -3bridgeB ] 


Change this line 


if(<compare([signal],"equal",4)>,<umptoscript("crossT -3")>,<null()>); //next 


To: 


if(<compare([signal]," equal" ,4)>,<umptoscript("crossT -2.0bridgeN ")>,<null()>); //next 


And put the following body on the crossT -2.0bridgeN : 


if(<compare([crossT amend],"equal",0)>,<umptoscript("crossT -3")>,<jumptoscript("crossT -2.1")>); 


Now testing the game, nothing was different. That's a good sign. N ow let's do the second part: the 
crossT -3bridgeB part. 


if(<compare([signal],"equal",3)>,<umptoscript("crossT -2.0")>,<null()>); //prev 


ef p ~~ 


Changes to: 


if(<compare([signal]," equal" ,3)>,<umptoscript("crossT -3bridgeB")>, <null()>); //prev 


And: 
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[crossT -3bridgeB ] 
if(<compare([crossT amend],"equal",0)>,<umptoscript("crossT -2.0")>,<qumptoscript("crossT -2.1")>); 


Testing again won't give any difference so, what is missing? If you noticed, we must set the variable 
crossT amend1 to a value different from 0! W e do that in the 2.0's press! First we will create a two new functions (so we 
can make like we did with Advanced Cross Examination example): crossT -2.0pressO and crossT -2.0pressD ! 

Let's see how it would turn out: 


[crossT -2.0press] 
if(<compare([crossT amend1],"equal",0)>,<umptoscript("crossT -2.0pressO ")>,<jumptoscript("crossT -2.0pressD ")>); 


[crossT -2.0pressO ] 
setmsgboxtextcolor(255,255,255,255); 
runscript("hideowmenu"); 
runscript("pw_showadvarrowmenu"); 
runscript("pw_hidemessagebox"); 
runscript("pw_raiseholdit"); 
modifyvar([pwcrossexamstages],"add",1); 
setvar([crossT amend1],1); 
runscript("pw_showmessagebox"); 
message("W hat kind of shadow you ask?"); 
message("H mmm, | recall it was a man's shadow."); 
message{"I'Il amend it to my testimony."); 
runscript("hidepwmenu"); 
runscript("showpwcrossexamination"); 
runscript("nextpwcrossexamsi mple"); 
jumptoscript("crossT -2.1"); 


[crossT -2.0pressD ] 
runscript("nextpwcrossexamsimple"); 
jumptoscript("crossT -2.1"); 


The pressO one defines the "first time you press". It recalls the advance arrow window and does a talk. 
Also it ADDS 1 to the number of stages and sets the crossT amend1 variable to 1 (so the 2.1 will be accessed now). The 
pressD one is the "after the first press" result of pressing statement 2.0 (so we don't re-amend 2.1 over and over, witch is 
wrong). We use the function showpwcrossexamination to show the lower screen (resuming to the Cross Examination 
interface). 

Thus it concludes out tutorial. A hard one, the hardest one in the book. N ow things will get easier. W e 
are almost there. 
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Tutorial 07: 


U sing the Lifebar 


The life bar isn't a Court Room exclusive feature (if you consider Psyche Locks), but it fits better than 
anywhere else. It is the only place you can really go game over, so we can also explain how to check for the player’s life 
and if give it a game over (J udge patience hitting zero). 


Due to PW Lib's versatility, we can even define the value of the player's max life. For that we set the 
variable pw_lifemax with the desired value. By default, it is 100.0. T he .0 is required. 


setvar([pw_lifemax],100.0); 


We set the variable pw_lifecurrent as the current life the player has. If you redefine the maxvalue, you 
need to change this one too. 


setvar([pw_lifecurrent],100.0); 


You can do that to recover/take the player's life when needed (as Psyche Locks "Unlock Successful" effect 
isnot on PW Lib H ayase). T here is another variable that is used on life bar operations: the pw_lifeflash. 


setvar([pw_lifeflash],40.0); 


It is used when you show the life bar to set how much of the bar will be orange (40 life points in this 
case). 
And the last part: showing and hiding. T o show: 


runscript("pw_showlifebar"); 


And to hide: 


runscript("pw_hidelifebar"); 


And you're set with life bar operations. 


This concludes the Court Room T utorials. 


nvestigation Tutorials 


“Walking around can be more interesting if you view things differently.” 


After learning the basics on the Court, your last step to overcome is the Investigation interface. W alk 
around, get clues and talk to a lot of people This is what Investigation is for! Using all you learned earlier you will be 
able to expand the lessons here and give your game an unique investigation route. Good luck with your ideas. Walking 
around can be more interesting, just think and view things differently. They aren’t the same in all possible perspectives. 
The truth is there to be seen. 
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Tutorial 01: 
Configuring a Standard Place 
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The last feature of a Phoenix Wright game: the Investigation. It unifies a lot of previously seem features, 
such as Present and Examine, but with some simple differences. As you may renember, an investigation areain the game 
had 2 formats: the standard (with all 4 buttons - Examine, Present, Talk and M ove) and the minimal (2 buttons - M ove 
and Examine). This first tutorial will help setting up the standard format. The minimal one will rey on explanations 
here shown, so make sure you don't try to skip this one. 

As with other features, we need to say to PW Lib what we want to do. Investigation is no different. For a 
place, you create a function. This function will take you to your "place" and show the Investigation Interface, 
configuring it as you want. H ere is an example of such function: 


[lobbynormal] 

runscript("hideowmenu"); 
runscript("pw_hidemessagebox"); 
setbuttonarea("pw_examineareal",157,302,81,23); 
setvar([pw_examinemaxplaces],1); 
setvar([pw_examineexaminefunction],"game24"); 
setbuttongraphic("pw_investigtalk1",9000,9000); 
setvar([pw_talkoption1],"game24"); 
setvar([pw_talkmaxoptions], 1); 
setbuttongraphic("pw_investigmovel",9000,9000); 
setvar([pw_moveoption1],"game24"); 
setvar([pw_movemaxplaces], 1); 
setvar([pw_examinepresentfunction],"game24"); 
runscript("pw_showinvestigationfull"); 
jumptoscript("pw_investigprocessactions'); 


Taking on from an example will be far easier. First we hide the current lower screen and the M essage Box 
(we don't need it there). Then we setup the EXAMINE areas as we did in the Examine Tutorial. But differently from 
examines we seen, the Examine verification part is outside of this function. You must create a function and put its name 
on the pw_examineexaminefunction variable. eg: 


setvar([pw_examineexaminefunction],"locl2exam"); 


[locl2exam] 


And in the function you created, you check the Examine as usual. 
N ow you need to setup the T alk. Talk can have at most 4 buttons. First, we define the graphics for them 
using: 


setbuttongraphic("pw_investigtalk1",9000,9000); 


— [a [| 


You can use pw_investigtalk1, pw_investigtalk2, pw_investigtalk3 and pw_investigtalk4. The numbers 
are the textures you will use for the button (the first is the normal and the second is when you hover on the talk button). 
With it done, you need to create one function for each button you will use. It will be where the script will go as you click 
the button on Talk. and to complete, you set the number of buttons you will use: 
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setvar([pw_talkmaxoptions],1); 


Up to 4. 
M ove is exactly like talk to setup, but just with different names: 


setbuttongraphic("pw_investigmovel",9000,9000); 
setvar([pw_moveoption1],"game24"); 
setvar([pw_movemaxplaces], 1); 


Here is an example pw_investigtalkl -> pw_investigmovel, pw_talkoption1 -> pw_moveoption1 and 
pw_talkmaxoptions ->pw_movemaxplaces. 

And we finished setupping the parameters for the Investigation! N ext we use this function to show the 
investigation window: 


runscript("pw_showinvestigationfull"); 


And completes with this other one: 


jumptoscript("pw_investigprocessactions'); 


To tdl PW Lib to wait for the player's actions. And you just did an investigation area. You can create 
variables and use the if to make different configurations according to the state of the game, and make the game way more 
dynamic. N ow let's explain the M inimal Place in the next tutorial! 


Tutorial 02: 


Configuring a M inimal Place 


This tutorial will be short. First, since we only use the Examine and M ove, we only need to configure 
both, just like we did in the previous tutorial. O nce it's set, you use this function: 
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runscript("pw_showinvestigationhalf"); 


Instead of the 


runscript("pw_showinvestigationfull"); 


To call the "half" (minimal) version of the investigation. This is also required: 


jumptoscript("pw_investigprocessactions’); 


Asin Standard Place. and there you go with the M inimal Place: 


[lobbyminimal] 

runscript("hideowmenu"); 
runscript("pw_hidemessagebox"); 
setbuttonarea("pw_examineareal",157,302,81,23); 
setvar([pw_examinemaxplaces],1); 
setvar([pw_examineexaminefunction],"game24"); 
setbuttongraphic("pw_investigmovel",9000,9000); 
setvar([pw_moveoption1],"game24"); 
setvar([pw_movemaxplaces], 1); 
runscript("pw_showinvestigationhalf"); 
jumptoscript("pw_investigprocessactions’); 


And only one more tutorial in the Investigation to go: Psyche Locks! 
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T utorial 03: 


Psyche Locks 


Psyche Locks were a feature long expected. PW Lib supports it, and if you did read the basic tutorials, you 
may guess how to do them. In reality, Psyche Locks are collections of Presents with a Stop button. As you may know 
already about Presenting, I'll skip explaining how it works and focus on the definition of the Stop and how to handle it. 
This tutorial won't explain the complete process of making a Psyche Lock because of the lack of good chains. We will 
explain how to invert the background and use the Stop on Presenting. 

To invert the background we use a feature of AIGE named AH LTL. It isa language sister to AH LSL that 
is directed to texture editing. First, you need to include an AH LTL file In this case we will include the inversion. hitl. To 
include an AH LTL file: 


#includehit(inversion. hitl) 


And you can use the hitl file's functions in textures. To apply the inversion (or any other effect) to a 
texture, you use this function: 


processtexture(220,0,"inversion"); 


The value 220 is the texture we want to edit. 0 is the texture we want to backup the first texture to (0 
means we won't use it). The "inversion" isan AH LTL function's name. the inversion.hltl has an AH LTL function called 
inversion. To apply to the current background, you can use the variable pw_currentbackground. Just renember to 
reapply the effect to restore the texture (applying inversion on an inversion returns to the original texture) before 
changing backgrounds. 

N ow let's explain the Stop functionality of the Present. H ere is the code of an already seen Present: 


[presenttrucyevidence] 

definevar([signal],"int"); 

runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 
runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 
runscript("pw_hidemessagebox"); 
runscript("pw_raisetakethat"); 

wait(6); 
if(<compare([currentitemcode],"equal",902)>,<umptoscript("presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


First, you will need to break it onto three functions: 


[presenttrucyevidence] 
definevar([signal],"int"); 
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runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 
runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 


[presenttrucyevidence? ] 

runscript("pw_hidemessagebox"); 

runscript("pw_raisetakethat"); 

wait(6); 
if(<compare([currentitemcode],"equal",902)>,<umptoscript("presenttrucyevidencecorrect")>,<umptoscript("presenttru 
cyevidencewrong")>); 


[presenttrucyevidenceS] 
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N ow the S version is the action to take on the case of Stop click and the P in the case of the Present click. 
W e just need to examine the variable signal to determine witch is the player's action. W e use an if. If the value is 1, we 
got a present click. If it isn't (internally it is 42), we got a Stop. 


if(<compare([signal],"equal",1)>,<umptoscript("presenttrucyevidenceP")>,<umptoscript("presenttrucyevidenceS") >): 


There you do. Stop will be analyzed. 


[presenttrucyeviden ce] 

definevar([signal],"int"); 

runscript("pw_setnameboxtonoone’); 

messageauto("(Show what proves that T rucy is \na magician!)"); 

runscript("pw_forcepresent"); 

waitsignal("advance" [signal ]); 
if(<compare([signal],"equal",1)>,<umptoscript("presenttrucyevidenceP")>,<umptoscript("presenttrucyevidenceS")>): 


There is the result you want, and one more tutorial completed. 
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ustomization T utorials 


“The limit is only your creativity.” 


After along and hard journey, you finally reached the last part of the book. With all features learned, the 
only thing that separates you from your Ace Attorney game is adding your own content. This small set of tutorials will 
give you the guidance necessary to add your own characters and scenarios, as well your own customized balloons. You 
can skip this section if basic PW Lib already contains all your needs. 
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Tutorial 01: 
Creating a N ew Character 


The first lesson will be how to make your characters usable in PW Lib. Initially we will explain the base 
recommended format (as used in the PWLib’s SCSs - Standard Character Sets). We deploy two main functions: the 
creator and the loader. I’ll use a random Character to demonstrate: 
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[pw_createyumi] 


[pw_loadyumifiles] 


W e will run the load one in the create one: 


[pw_createyumi] 
runscript(“pw_loadyumifiles”); 


So when you call the create f unction, it will load the images needed. The load function will contain 
loadtexture commands for the sheets you will use in yumi (or your character). Those sheets can easily be done on any 
format you like. KSA Technology recommends using up to 6 cells per file if making the “sheet mode”. The already 
available characters that deployed with PW Lib can be a good reference. 

N ow we need to make the animations for the characters. W e will make two animations for each pose, one 
for silent and other for talking. To do that, we use AIGE’s animation controls. There are three main functions for such 


task: 


createanimation("Yumi_N ormal",1); 
insertanimationframe("Yumi_N ormal",1,12000,200); 
setanimationframetexturecoordinates("Yumi_N ormal",1,0,0,119,169); 


The first one creates an animation with a given name We normally use <charname>_<charpose>. The 
second parameter is a bogus one and used for compatibility and can be any value. 

The second one creates a frame in a given animation. The first parameter is the animation’s name, The 
second id the frame to create (that is one more than the previous one, starting in 1). The third is the texture id we will be 
using, and the last parameter is the delay for that frame. T he delay is like we use with waits, it is f/60 seconds. 

The last command is used to get a cell of a character sheet. You don’t need to use it if you’re using one 
cell per image. T he first parameter defines the animations name. The second one is the frame. The third the starting x 
and the forth the starting y. The last two configure the width and height of the image to get starting on the x and y 
defines in the previous two parameters. 

To make your animation you use the second and third functions according to the number of frames in 
your character. H ere is an example of a N ormal pose for the N yala character: 


createanimation("N yala_N ormal",1); 
insertanimationframe("N yala_N ormal",1,12000,200); 


— fosoj 
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setanimationframetexturecoordinates("N yala_N ormal",1,0,0,119,169); 
insertanimationframe("N yala_N ormal",2,12000,10); 
setanimationframetexturecoordinates("N yala_N ormal",2,0,170,119,169); 
insertanimationframe("N yala_N ormal",3,12000,10); 
setanimationframetexturecoordinates("N yala_N ormal",3,120,170,119,169); 
insertanimationframe("N yala_N ormal",4,12000,10); 
setanimationframetexturecoordinates("N yala_N ormal",4,0,170,119,169); 
createanimation("N yala_N ormal_T alking",1); 

insertanimationframe("N yala_N ormal_T alking",1,12000,5); 
setanimationframetexturecoordinates("N yala_N ormal_Talking",1,0,0,119,169); 
insertanimationframe("N yala_N ormal_T alking",2,12000,5); 
setanimationframetexturecoordinates("N yala_N ormal_T alking",2,240,0,119,169); 
insertanimationframe("N yala_N ormal_T alking",3,12000,5); 
setanimationframetexturecoordinates("N yala_N ormal_Talking",3,120,0,119,169); 
insertanimationframe("N yala_N ormal_T alking",4,12000,5); 
setanimationframetexturecoordinates("N yala_N ormal_T alking",4,240,0,119,169); 


And that is almost done with your character. N ow you need to make a function for each pose (like the 
ones you seen of Ema) for extra easiness. T hose functions follow the same format, only changing parameters: 


[pw_enablenyalanormal] 

placecharacter("pw_char",70,20); 
setcharactersize"pw_char",120,170); 
setcharacterlipsyncsilent("pw_char","N yala_Normal"); 
setcharacterlipsynctalking("pw_char","N yala_N ormal_ Talking"); 


First you set where the character will be. The reference point is the top left corner. W e reference 0,0 from 
the top left corner of the window too. N egative values are totally out of the screen, so you will only use positive values 
unless necessary. Second, we set the character size. That’s the size of your character image (if one cell per image) or cell. 
Third, we set the silent animation for the character. The second parameter is the animation’s name for that. And forth is 
the same as the third, but for the talking animation. N ote that the first parameter will NEVER change. 

The last thing to do is setting the name box (in this example Ema): 


//Ema's N amebox 

[pw_setnameboxtoema] 
setgenobjtexturecoordinates("pwnamebox",100,84,50,14); 
showgenobj("pwnamebox"); 


We only set the first line (it is like the animation one, starting X, starting Y, width and height. If you 
want to use the whole, you use the width and height as the image’s width and height. In this case, it should be 50,14. 
Also, both the starting X and starting Y would need to be 0: 


[pw_setnameboxtoyumi] 
setgen objtexturecoordinates("pwnamebox",0,0,50,14); 
showgenobj("pwnamebox"); 


And this concludes our N ew Character addition tutorial. 
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Tutorial 02: 
Creating a N ew Background 


We will make a function to set the background, just like We did with characters. But couldn’t we just use 
the setbg? T he response is no, because we want it to integrate with the examine. That’s the reason we have to do that to 
backgrounds. But the function itself is fairly simple 
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[pw_usepwhbgcourthall] 

setbg(220); 
setvar([pw_currentbackground],220); 
setbgsizefromtexture(); 


This example is from the PWLib’s Standard Background Set. We load a background with an id first, as 
usual. Then we create a function for this background. T he first line uses the background. T he second records it on the 
currentbackground variable, so PW Lib will use it automatically on the Examine (on Investigation). The last command 
makes sure the size of the bg object is the same of the image provided. W e recommend keeping the 256x192 size. 

N ow all you need to do is use the function and your background will be set. N othing complicated. 
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Tutorial 03: 
Creating Custom Balloons 


The last tutorial in this version of the book, we will teach how to make new balloons. T hey are as easy as 
backgrounds to make. H ere is the hold it raise function: 


[pw_raiseholdit] 

setvar([pwdoingyell],1); 
setgenobjgraphic("pw_yell",12); 
setgenobjsizefromtexture{"pw_ yell"); 
showgenobj("pw_ yell"); 
placeshake("pw_yell","genobj",60,20,19); 
wait(60); 

hidegenobj("pw_ yell"); 
setvar([pwdoingyell],0); 


We will keep this same format, and only change the 12 in line 2 to the id of the texture of your balloon. 
So acustom balloon code would be (if the new balloon’s graphic is 1297): 


[pw_raisestopthere] 
setvar([pwdoingyell],1); 
setgenobjgraphic("pw_yell",1297); 
setgenobjsizefromtexture{"pw_ yell"); 
showgenobj("pw_ yell"); 
placeshake("pw_yell","genobj",60,20,19); 
wait(60); 

hidegenobj("pw_ yell"); 
setvar([pwdoingyell],0); 


And you got your new balloon working. Your balloon can be used as usually you would do with the 
standard ones. T his concludes our last tutorial. 
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